DuckDuckGo MCP Server
The DuckDuckGo MCP Server enables web searches with configurable parameters:
Execute web searches using the DuckDuckGo service for general queries, news, articles, and online content
Filter results by specifying the number of results (1-20) and applying SafeSearch levels (strict, moderate, or off)
Obtain results formatted in Markdown
Rate limits: 1 request per second and 15,000 requests per month
Allows performing web searches using the DuckDuckGo API, with support for configuring the number of results and SafeSearch settings
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@DuckDuckGo MCP Server search for latest AI developments in healthcare"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
duckduckgo-search MCP Server
English | 中文
A Model Context Protocol server for DuckDuckGo Search
This is a TypeScript-based MCP server that provides DuckDuckGo search functionality. It demonstrates core MCP concepts through:
Integration with DuckDuckGo Search
Easy-to-use search tool interface
Rate limiting and error handling support
Features
Search Tool
duckduckgo_search- Perform web searches using DuckDuckGo APIRequired parameter:
query(search query, max 400 characters)Optional parameter:
count(number of results, 1-20, default 10)Optional parameter:
safeSearch(safety level: strict/moderate/off, default moderate)Returns formatted Markdown search results
Rate Limits
Maximum 1 request per second
Maximum 15000 requests per month
Related MCP server: DuckDuckGo MCP Server
Development
Prerequisites
Node.js >= 18
pnpm >= 8.0.0
Installation
# Install pnpm if not already installed
npm install -g pnpm
# Install project dependencies
pnpm installBuild and Run
Build the server:
pnpm run buildFor development with auto-rebuild:
pnpm run watchSetup in Claude Desktop
To use with Claude Desktop, add the server config:
On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
# online
{
"mcpServers": {
"duckduckgo-search": {
"command": "npx",
"args": [
"-y",
"duckduckgo-mcp-server"
]
}
}
}
# local
{
"mcpServers": {
"duckduckgo-search": {
"command": "node",
"args": [
"/path/to/duckduckgo-search/build/index.js"
]
}
}
}
Debugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
pnpm run inspectorThe Inspector will provide a URL to access debugging tools in your browser.
Available Tools
1 toolduckduckgo_web_searchB
Performs a web search using the DuckDuckGo, ideal for general queries, news, articles, and online content. Use this for broad information gathering, recent events, or when you need diverse web sources. Supports content filtering and region-specific searches. Maximum 20 results per request.
Inputs: query (required), count, safeSearch.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools. The tool's purpose is clearly defined as performing web searches using DuckDuckGo.
Since there is only one tool, naming consistency is inherently perfect. The tool name 'duckduckgo_web_search' follows a clear verb_noun pattern that would be appropriate if more tools were added.
A single tool for a web search server is too minimal for the apparent scope. While the tool covers basic search functionality, a more complete surface would likely include additional tools such as for image search, news search, or advanced query options, making this feel thin and incomplete.
The tool surface is severely incomplete for a DuckDuckGo server. It only provides general web search, missing obvious functionalities like image search, video search, instant answers, or autocomplete, which are core features of DuckDuckGo. This will limit agents to basic queries without specialized capabilities.
Maintenance
Related MCP Connectors
Web search API and MCP server for developers building AI agents.
Hosted Web Crawler MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Free web search for AI agents. No API key required. Hosted MCP in active development.
Related MCP Servers
- AlicenseAqualityBmaintenanceA Model Context Protocol (MCP) server that provides web search capabilities through DuckDuckGo, with additional features for content fetching and parsing.320,901 PyPI1,584MIT
- FlicenseBqualityDmaintenanceA server that provides DuckDuckGo search capabilities (text, image, news, video search and AI chat) through the Model Context Protocol.516-
- AlicenseCqualityCmaintenanceA Model Context Protocol server implementation that enables AI assistants like Claude to perform Google searches and retrieve web data directly through natural language requests.1140 npm170MIT
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables AI applications like Claude Desktop and Cursor IDE to perform web searches via DuckDuckGo's search engine.-