ddg-mcp MCP server

@misanthropic-ai

About ddg-mcp MCP server

DuckDuckGo search API MCP server

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "ddg-mcp": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

Tools

Search the web for text results using DuckDuckGo

Search the web for images using DuckDuckGo

Search for news articles using DuckDuckGo

Search for videos using DuckDuckGo

Chat with DuckDuckGo AI

Overview

What is ddg-mcp?

ddg-mcp is a Model Context Protocol (MCP) server that provides DuckDuckGo search capabilities — including text, image, news, and video search — plus an AI chat feature, allowing AI assistants to query DuckDuckGo directly.

How to use ddg-mcp?

Install the package via uv install ddg-mcp or pip install ddg-mcp, then add it to your MCP client configuration (e.g., Claude Desktop) using the uvx command. Once configured, your AI assistant can invoke the provided tools (e.g., ddg-text-search, ddg-image-search) or use the search-results-summary prompt.

Key features of ddg-mcp

DuckDuckGo text, image, news, and video search tools
AI chat with multiple model options (GPT-4o mini, Llama 3.3 70B, Claude 3 Haiku, etc.)
Search results summary prompt with optional detail level
Customizable parameters: region, safesearch, timelimit, max_results
Supports advanced search operators (filetype, site, intitle, inurl, etc.)
Image-specific filters (size, color, type, layout, license)

Use cases of ddg-mcp

An AI assistant retrieves current web information via DuckDuckGo text search
A user searches for images with specific color or size constraints
Finding recent news articles on a topic with a time limit
Discovering educational videos filtered by duration and resolution
Having a conversational AI interaction using DuckDuckGo’s AI chat

FAQ from ddg-mcp

What dependencies does ddg-mcp require?

Python 3.9 or higher and the duckduckgo-search package, which is installed automatically when you install ddg-mcp.

How do I configure ddg-mcp for Claude Desktop?

Add the server to your Claude Desktop configuration file (claude_desktop_config.json) with the command uvx ddg-mcp (for published servers) or a local path for development.

What search operators are available?

You can use operators such as "exact phrase", +/- to include/exclude, filetype:pdf, site:example.com, intitle:, and inurl:.

What parameters are common across all search tools?

Common parameters include region, safesearch, timelimit, and max_results. Default safesearch is "moderate" and max_results is 10.

Which AI chat models are supported?

Supported models: gpt-4o-mini, llama-3.3-70b, claude-3-haiku, o3-mini, and mistral-small-3.

Frequently asked questions

What dependencies does ddg-mcp require?

Python 3.9 or higher and the `duckduckgo-search` package, which is installed automatically when you install `ddg-mcp`.

How do I configure ddg-mcp for Claude Desktop?

Add the server to your Claude Desktop configuration file (`claude_desktop_config.json`) with the command `uvx ddg-mcp` (for published servers) or a local path for development.