ddgs-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DDGS_PROXY | No | Proxy URL passed to DDGS (e.g. http://127.0.0.1:1080). Useful behind a rotating proxy to avoid bans. | |
| DDGS_REGION | No | Default region code (e.g. pl-pl, de-de, wt-wt). | us-en |
| DDGS_BACKEND | No | Default backend for search calls. | auto |
| DDGS_TIMEOUT | No | Per-request timeout in seconds. | 10 |
| DDGS_MCP_LOG_LEVEL | No | Server log verbosity. | INFO |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| web_searchA | Web search (web results) via DDGS metasearch. No API key. Args: query: search query. max_results: number of results (1-25). region: e.g. "us-en", "pl-pl", "de-de", "wt-wt" (worldwide, no region). safesearch: "on" | "moderate" | "off". timelimit: "d" (day), "w" (week), "m" (month), "y" (year), or None. backend: "auto" (randomized multi-engine, recommended) or specific: duckduckgo, bing, brave, google, mojeek, startpage, yahoo, wikipedia, grokipedia. snippet_chars: max snippet length per result (0 = no snippet). |
| news_searchA | News search via DDGS (DuckDuckGo/Bing/Yahoo news backends). No API key. Args: query: news query. max_results: number of results (1-25). region: e.g. "us-en", "pl-pl", "wt-wt". timelimit: "d" | "w" | "m" | "y" or None. backend: "auto" or one of: duckduckgo, bing, yahoo. snippet_chars: max snippet length (0 = none). |
| image_searchA | Image search via DDGS (DuckDuckGo/Bing image backends). No API key. Args: query: image query. max_results: number of results (1-25). region: e.g. "us-en", "wt-wt". safesearch: "on" | "moderate" | "off". backend: "auto" or one of: duckduckgo, bing. |
| video_searchA | Video search via DDGS (DuckDuckGo video backend). No API key. Args: query: video query. max_results: number of results (1-25). region: e.g. "us-en", "wt-wt". backend: "auto" or "duckduckgo". snippet_chars: max description length (0 = none). |
| web_extractA | Extract readable content from 1-5 web pages (markdown by default). Use after web_search/news_search to read the actual page content. Args: urls: 1-5 absolute http(s) URLs to extract. max_chars: max characters of content returned per page (default 6000). fmt: "text_markdown" | "text_plain" | "text_rich" | "text" (raw HTML) | "content" (bytes->str). |
| search_statusA | Health/diagnostics: DDGS version, configured backend/region/timeout/proxy, available backends per category, and a live ping search. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool targets a distinct content type or function: web, image, news, video, page extraction, and service diagnostics. There is no meaningful overlap in purpose, so an agent should rarely misselect among them.
Names are uniformly lowercase snake_case and mostly follow a `<type>_search` pattern for the four search tools. `web_extract` and `search_status` are minor structural deviations, but they remain clear and predictable in style.
Six tools is a well-scoped size for a search-focused server: four content-type searches, one extraction tool, and one diagnostics tool. Every tool has a clear role and none feel redundant or unnecessary.
The server covers the core search lifecycle: querying web, image, news, and video results, then extracting readable content from results, plus health diagnostics. There are no obvious missing operations for its stated purpose.