DuckDuckGo

v0.1.2Search & Data Extractionstable

A free and unlimited web search server that enables AI models to search, crawl, and research web content using DuckDuckGo without requiring API keys. It features parallel crawling and a smart ranking system to prioritize the most relevant information

duckduckgo-mcp-servermcpai-integration
Share:
1,170
Stars
0
Downloads
0
Weekly
0/5

What is DuckDuckGo?

DuckDuckGo is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to free and unlimited web search server that enables ai models to search, crawl, and research web content using duckduckgo without requiring api keys. it features parallel crawling and a smart ranking sy...

A free and unlimited web search server that enables AI models to search, crawl, and research web content using DuckDuckGo without requiring API keys. It features parallel crawling and a smart ranking system to prioritize the most relevant information

This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A free and unlimited web search server that enables AI model

Use Cases

Search the web using DuckDuckGo without API keys.
Crawl and rank web content with intelligent prioritization.
Access unlimited free web search in MCP workflows.
nickclyde

Maintainer

LicenseMIT
Languagepython
Versionv0.1.2
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y duckduckgo-mcp-server

Manual Installation

npx -y duckduckgo-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use DuckDuckGo

DuckDuckGo MCP Server gives AI models free, unlimited web search and webpage content retrieval through DuckDuckGo, requiring absolutely no API keys or account sign-ups. It exposes two MCP tools — a search tool that queries DuckDuckGo and returns ranked results, and a fetch tool that retrieves full page text from any URL — making it ideal for grounding AI responses in current web content. The server includes built-in rate-limit protection, configurable SafeSearch filtering, and optional TLS impersonation via curl_cffi for sites that block standard HTTP clients.

Prerequisites

  • Python 3.10+ and uv or pip installed
  • No API keys required — DuckDuckGo search is free and unlimited
  • An MCP-capable client such as Claude Desktop, Claude Code, or any MCP-compatible tool
1

Install the server

The recommended installation method is via uv (uvx for zero-install execution) or pip. Install the optional browser backend if you encounter bot-detection issues on certain sites.

# Zero-install run via uvx
uvx duckduckgo-mcp-server

# Or install via pip/uv
uv pip install duckduckgo-mcp-server

# With optional browser backend for bypassing bot detection
uv pip install "duckduckgo-mcp-server[browser]"
2

Configure Claude Desktop

Add the server entry to your claude_desktop_config.json. Use DDG_SAFE_SEARCH and DDG_REGION environment variables to control filtering and locale. SafeSearch can be STRICT, MODERATE, or OFF.

{
  "mcpServers": {
    "duckduckgo": {
      "command": "uvx",
      "args": ["duckduckgo-mcp-server"],
      "env": {
        "DDG_SAFE_SEARCH": "MODERATE",
        "DDG_REGION": "us-en"
      }
    }
  }
}
3

Restart your MCP client

Quit and reopen Claude Desktop (or reload the MCP host) so it starts the DuckDuckGo server process. The search and fetch tools will appear once the server is running.

4

Test the search tool

Ask your AI assistant to search for something current. The search tool accepts a query, optional max_results (default 10), and an optional region override.

DuckDuckGo Examples

Client configuration

Claude Desktop config entry for DuckDuckGo MCP Server with SafeSearch and US English region settings.

{
  "mcpServers": {
    "duckduckgo": {
      "command": "uvx",
      "args": ["duckduckgo-mcp-server"],
      "env": {
        "DDG_SAFE_SEARCH": "MODERATE",
        "DDG_REGION": "us-en"
      }
    }
  }
}

Prompts to try

Example prompts that exercise both the search and content-fetch capabilities of the server.

- "Search the web for the latest news on Model Context Protocol and summarize the top 5 results"
- "Find recent benchmarks comparing Claude and GPT-4o, then fetch and summarize the first result"
- "Search DuckDuckGo for 'Python async best practices 2025' and list the main recommendations"
- "Fetch the content of https://modelcontextprotocol.io and give me an overview of the page"
- "Search for 'open source MCP servers' and tell me which repositories have the most stars"

Troubleshooting DuckDuckGo

Search returns no results or throws a rate-limit error

The server has built-in rate-limit protection, but heavy usage may still trigger DuckDuckGo throttling. Reduce request frequency or add a short delay between searches. The [browser] extra (curl_cffi) can help bypass some blocks.

Content fetch tool fails on certain websites

Some sites block standard httpx clients. Install the browser backend with 'uv pip install duckduckgo-mcp-server[browser]' and set the --fetch-backend flag to 'curl' or 'auto' in your server args to enable TLS impersonation.

uvx command not found

Install uv first with 'pip install uv' or via the official installer at astral.sh/uv. Alternatively, install the package directly with 'pip install duckduckgo-mcp-server' and use 'duckduckgo-mcp-server' as the command.

Frequently Asked Questions about DuckDuckGo

What is DuckDuckGo?

DuckDuckGo is a Model Context Protocol (MCP) server that free and unlimited web search server that enables ai models to search, crawl, and research web content using duckduckgo without requiring api keys. it features parallel crawling and a smart ranking system to prioritize the most relevant information It connects AI assistants to external tools and data sources through a standardized interface.

How do I install DuckDuckGo?

Install via npm with the command: npx -y duckduckgo-mcp-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with DuckDuckGo?

DuckDuckGo works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is DuckDuckGo free to use?

Yes, DuckDuckGo is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Search & Data Extraction MCP Servers

Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "duckduckgo-mcp-server": { "command": "npx", "args": ["-y", "duckduckgo-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use DuckDuckGo?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides