v1.0

duckduckgo-mcp/README.md

@@ -4,7 +4,13 @@ MCP server that exposes DuckDuckGo search to Javis via three tools:
 
 - **`ddg_search`** — general web search (titles, URLs, snippets)
 - **`ddg_news`** — recent news articles
-- **`ddg_answers`** — instant answers (definitions, calculations, Wikipedia summaries)
+- **`ddg_answers`** — quick lookups; DuckDuckGo removed its instant-answer API, so
+  this returns the top 3 web results
+
+Searches run in a worker thread (the server stays responsive), and failures such
+as DuckDuckGo rate limits are returned as MCP tool errors (`isError: true`), so
+clients don't mistake or cache them as results. All tools are annotated
+`readOnlyHint` / `openWorldHint`.
 
 ## Setup
 
@@ -18,7 +24,7 @@ The batch script creates a `.venv`, installs dependencies, and launches the serv
 
 ```json
 "duckduckgo": {
-  "command": "d:\\Javis\\duckduckgo-mcp\\.venv\\Scripts\\duckduckgo-mcp.exe",
+  "command": "F:\\Javis\\duckduckgo-mcp\\.venv\\Scripts\\duckduckgo-mcp.exe",
   "args": [],
   "transport": "stdio",
   "approval": "allow"