# Ddg Search

> A powerful Model Context Protocol (MCP) server for web search and URL content extraction using DuckDuckGo.

- **Type:** MCP server
- **Install:** `agentstack add mcp-oevortex-ddg-search`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [OEvortex](https://agentstack.voostack.com/s/oevortex)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [OEvortex](https://github.com/OEvortex)
- **Source:** https://github.com/OEvortex/ddg_search
- **Website:** https://www.npmjs.com/package/@oevortex/ddg_search

## Install

```sh
agentstack add mcp-oevortex-ddg-search
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

DuckDuckGo, IAsk AI, Monica & Brave AI Search MCP 🔍🧠
  
    Lightning-fast, privacy-first Model Context Protocol (MCP) server for web search and AI-powered answers.
    Powered by DuckDuckGo, IAsk AI, Monica, and Brave AI.
  
  
    
  
  
  Subscribe for updates & tutorials

---

> [!IMPORTANT]
> DuckDuckGo Search MCP supports the Model Context Protocol (MCP) standard, making it compatible with various AI assistants and tools.

---

## ✨ Features

  🌐 Web search using DuckDuckGo HTML
  🧠 AI search using IAsk AI, Monica & Brave AI
  ⚡ Performance optimized with caching
  🛡️ Security features including rate limiting and rotating user agents
  🔌 MCP-compliant server implementation
  🆓 No API keys required - works out of the box

> [!IMPORTANT]
> Unlike many search tools, this package performs actual web scraping rather than using limited APIs, giving you more comprehensive results.

---

## 🚀 Quick Start

Run instantly with npx:

```bash
npx -y @oevortex/ddg_search@latest
```

> [!TIP]
> This will download and run the latest version of the MCP server directly without installation – perfect for quick use with AI assistants.

---

## 🛠️ Installation Options

Global Installation (npm)

```bash
npm install -g @oevortex/ddg_search
```

Run globally:

```bash
ddg-search-mcp
```

Global Installation (Yarn)

```bash
yarn global add @oevortex/ddg_search
```

Run globally:

```bash
ddg-search-mcp
```

Global Installation (pnpm)

```bash
pnpm add -g @oevortex/ddg_search
```

Run globally:

```bash
ddg-search-mcp
```

Local Installation (Development)

```bash
git clone https://github.com/OEvortex/ddg_search.git
cd ddg_search
npm install
npm start
```

Or with Yarn:

```bash
yarn install
yarn start
```

Or with pnpm:

```bash
pnpm install
pnpm start
```

---

## 🧑‍💻 Command Line Options

```bash
npx -y @oevortex/ddg_search@latest --help
```

> [!TIP]
> Use the --version flag to check which version you're running.

---

## 🤖 Using with MCP Clients

> [!IMPORTANT]
> The most common way to use this tool is by integrating it with MCP-compatible AI assistants.

Add the server to your MCP client configuration:

```json
{
  "mcpServers": {
    "ddg-search": {
      "command": "npx",
      "args": ["-y", "@oevortex/ddg_search@latest"]
    }
  }
}
```

Or if installed globally:

```json
{
  "mcpServers": {
    "ddg-search": {
      "command": "ddg-search-mcp"
    }
  }
}
```

> [!TIP]
> After configuring, restart your MCP client to apply the changes.

---

## 🧰 Tools Overview

  
    🔍 Web Search Tool
    web-search
    
      query (string, required): The search query
      page (integer, optional, default: 1): Page number
      numResults (integer, optional, default: 10): Number of results (1-20)
    
    Example: Search the web for "climate change solutions"
  
  
    🧠 IAsk AI Search Tool
    iask-search
    
      query (string, required): The search query or question
      mode (string, optional, default: "question"): Search mode - "question", "academic", "forums", "wiki", or "thinking"
      detailLevel (string, optional): Response detail level - "concise", "detailed", or "comprehensive"
    
    Example: Search IAsk AI for "Explain quantum computing in simple terms"
  
  
    🤖 Monica AI Search Tool
    monica-search
    
      query (string, required): The search query or question
    
    Example: Search Monica AI for "Latest advancements in AI"
  

---

## 📁 Project Structure

```text
bin/              # Command-line interface
src/
  index.js        # Main entry point
  tools/          # Tool definitions and handlers
    searchTool.js
    iaskTool.js
    monicaTool.js
  utils/
    search.js     # Search and URL utilities
    user_agents.js
    search_monica.js
    search_iask.js # IAsk AI search utilities
package.json
README.md
```

---

## 🤝 Contributing

Contributions are welcome! Please open issues or submit pull requests.

> [!NOTE]
> Please follow the existing code style and add tests for new features.

---

## 📺 YouTube Channel

  
  
  youtube.com/@OEvortex

---

## 📄 License

Apache License 2.0

> [!NOTE]
> This project is licensed under the Apache License 2.0 – see the LICENSE file for details.

---

  Made with ❤️ by @OEvortex

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [OEvortex](https://github.com/OEvortex)
- **Source:** [OEvortex/ddg_search](https://github.com/OEvortex/ddg_search)
- **License:** Apache-2.0
- **Homepage:** https://www.npmjs.com/package/@oevortex/ddg_search

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-oevortex-ddg-search
- Seller: https://agentstack.voostack.com/s/oevortex
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
