Desearch MCP server
Desearch MCP is a hosted MCP server over Streamable HTTP. Create an API key in Desearch Console, then add the server in your agent. You do not need to install a package: the hosted endpoint is the recommended setup.
Endpoint: https://mcp.desearch.ai/mcp
1. Get your API key
- Open Desearch Console.
- Go to API Keys.
- Create a key and copy it once. Store it as
DESEARCH_API_KEY.
Send the key in the Authorization header as the raw key. Authorization: Bearer <key> and x-api-key: <key> also work.
2. Connect your client
Claude Code
claude mcp add --transport http desearch https://mcp.desearch.ai/mcp \
--header "Authorization: ${DESEARCH_API_KEY}"If your CLI build expects a different header flag, use the equivalent custom-header option and keep the same key value.
Claude Desktop
Claude Desktop: use the hosted URL if your client supports URL servers.
Clients that support OAuth
Use the remote connector URL https://mcp.desearch.ai/mcp. MCP clients that support OAuth can connect to that URL and sign in through OAuth. On the Desearch sign-in page you paste your Desearch API key.
Cursor
Add this to ~/.cursor/mcp.json:
{
"mcpServers": {
"desearch": {
"url": "https://mcp.desearch.ai/mcp",
"headers": {
"Authorization": "<DESEARCH_API_KEY>"
}
}
}
}VS Code
VS Code uses the servers key, not mcpServers. Add this to your user mcp.json:
{
"servers": {
"desearch": {
"type": "http",
"url": "https://mcp.desearch.ai/mcp",
"headers": {
"Authorization": "<DESEARCH_API_KEY>"
}
}
}
}For a step-by-step tested setup, see Use Desearch MCP in VS Code.
Any other MCP client
Use the hosted URL and match your client's header settings:
{
"url": "https://mcp.desearch.ai/mcp",
"headers": {
"Authorization": "<DESEARCH_API_KEY>"
}
}3. Check the connection
- Restart or reload the MCP session in your client.
- Confirm the Desearch server shows as connected.
- Confirm the tools appear from the live
tools/list. - Call a simple tool, such as
search-apiwith{"query":"desearch"}orai-searchwith{"prompt":"desearch docs"}.
Listing tools works without a key: initialize and tools/list are public. Calling a tool (tools/call) needs your key. GET https://mcp.desearch.ai/health returns 200 JSON when the host is up; it is a probe only, not a substitute for a keyed tool call.
Tools
Always go by your client's live tools/list: the inventory and titles can change, so do not hard-code a tool count.
Search
search-api(Search API): web search on the Desearch index. Setsummaryto true for a short answer written from the results, with numbered citations.ai-search(AI Search): X posts and web results, with an optional summary. Takesprompt.web-search(Web Search),x-search(X Search),x-links-search(X Links Search),search(Search),fetch(Fetch Page).web-links-searchis deprecated: usesearch-api.
X (Twitter) data
x-posts-by-urls,x-post-by-id,x-posts-by-user,x-post-retweeters,x-user-posts,x-user-replies,x-post-replies,x-trends.
Page content
extract(Extract Page Content): returns a page as text, markdown or html.web-crawl(Crawl Web Page, legacy).
Social platforms
youtube,reddit,threads,tiktok,facebook,instagram: each takes an action and that action's arguments.
People Search
people-search(billed), and the unbilledpeople-search-status,people-search-pause,people-search-resume,people-search-cancel,people-search-tasks,people-profiles. See People Search.
Company Search
company-searchandcompany-enrich(billed), and the unbilledcompany-search-status,company-search-pause,company-search-resume,company-search-cancel,company-search-tasks. See Company Search.
Credits and rates: Pricing.
Troubleshooting
| Symptom | Check |
|---|---|
Unauthorized error on tools/call | Send Authorization: <key> (Bearer <key> or x-api-key also work). Listing tools does not need a key. |
| Server missing | The config path for that client; restart the client. |
| Tools list empty | Network access to mcp.desearch.ai; key scope. |
| npm install fails | Use the hosted endpoint https://mcp.desearch.ai/mcp. |
FAQ
Do I need to install a package to use Desearch MCP?
No. The recommended setup is the hosted endpoint at https://mcp.desearch.ai/mcp. You add it in your agent with a Desearch API key.
Where do I get the API key?
Create it in Desearch Console under API Keys: https://console.desearch.ai/api-keys.
Can I list the tools without a key?
Yes. initialize and tools/list work without an API key. Calling a tool needs the key.
How many tools does the server have?
Check your client's live tools/list. The inventory can change, so do not hard-code a tool count.