ddg-mcp MCP server

DuckDuckGo search API MCP - A server that provides DuckDuckGo search capabilities through the Model Context Protocol.

Components

Prompts

The server provides the following prompts:

• search-results-summary: Creates a summary of DuckDuckGo search results
  • Required “query” argument for the search term
  • Optional “style” argument to control detail level (brief/detailed)

Tools

The server implements the following DuckDuckGo search tools:

• ddg-text-search: Search the web for text results using DuckDuckGo

  • Required: “keywords” - Search query keywords
  • Optional: “region”, “safesearch”, “timelimit”, “max_results”

• ddg-image-search: Search the web for images using DuckDuckGo

  • Required: “keywords” - Search query keywords
  • Optional: “region”, “safesearch”, “timelimit”, “size”, “color”, “type_image”, “layout”, “license_image”, “max_results”

• ddg-news-search: Search for news articles using DuckDuckGo

  • Required: “keywords” - Search query keywords
  • Optional: “region”, “safesearch”, “timelimit”, “max_results”

• ddg-video-search: Search for videos using DuckDuckGo

  • Required: “keywords” - Search query keywords
  • Optional: “region”, “safesearch”, “timelimit”, “resolution”, “duration”, “license_videos”, “max_results”

• ddg-ai-chat: Chat with DuckDuckGo AI

  • Required: “keywords” - Message or question to send to the AI
  • Optional: “model” - AI model to use (options: “gpt-4o-mini”, “llama-3.3-70b”, “claude-3-haiku”, “o3-mini”, “mistral-small-3”)

Installation

Prerequisites

• Python 3.9 or higher
• uv (recommended) or pip

Install from PyPI

# Using uv
uv install ddg-mcp

# Using pip
pip install ddg-mcp

Install from Source

1. Clone the repository:

git clone https://github.com/misanthropic-ai/ddg-mcp.git
cd ddg-mcp

2. Install the package:

# Using uv
uv install -e .

# Using pip
pip install -e .

Configuration

Required Dependencies

The server requires the duckduckgo-search package, which will be installed automatically when you install ddg-mcp.

If you need to install it manually:

uv install duckduckgo-search
# or
pip install duckduckgo-search

DuckDuckGo Search Parameters

Common Parameters

These parameters are available for most search types:

• region: Region code for localized results (default: “wt-wt”)

  • Examples: “us-en” (US English), “uk-en” (UK English), “ru-ru” (Russian)
  • See DuckDuckGo regions for more options

• safesearch: Content filtering level (default: “moderate”)

  • “on”: Strict filtering
  • “moderate”: Moderate filtering
  • “off”: No filtering

• timelimit: Time range for results

  • “d”: Last day
  • “w”: Last week
  • “m”: Last month
  • “y”: Last year (not available for news/videos)

• max_results: Maximum number of results to return (default: 10)