Desearch MCP server

Desearch MCP Server

A Model Context Protocol (MCP) server lets clients like Claude or Cursor use Desearch for real-time AI search, X search, web search, page extraction, and X trends.

Tools

The Desearch MCP server includes the following tools:

• AI Search (ai-search): Performs real-time AI Twitter and web searches with relevant links and summary. tools uses short source ids (web, twitter, arxiv, wikipedia, youtube, hackernews, reddit). Older labels such as Web Search are still accepted and sent to the API as the short id. Default is ["web", "twitter"].
• X Search (x-search): Real-time tweet search on X. Arguments: query (required), count (optional, default 20). Sort stays Top. Optional filters: user, startdate, enddate (YYYY-MM-DD), lang, verified, blueverified, isquote, isvideo, isimage, minretweets, minreplies, min_likes.
• Web Search (web-search): SERP-style web search. Arguments: query (required), start (optional pagination offset).
• Web Links Search (web-links-search): Web link search. Arguments: prompt (required), tools (optional, only web, default ["web"]; Web Search is accepted and rewritten to web), count (optional, 10–200). The links/web API rejects other sources, so they are not in the enum.
• Extract (extract): Read a public URL as text or HTML. Preferred over crawl. Arguments: url (required), format (optional, html or text), js (optional), wait (optional milliseconds).
• Web Crawl (web-crawl): Same arguments as extract, on the legacy /web/crawl route. The SDK marks webCrawl deprecated in favor of extract; this tool stays so that route remains reachable. Prefer extract for new integrations.
• X Links Search (x-links-search): AI search for X post links. Arguments: prompt (required), count (optional, 10–200).
• X Posts By URLs (x-posts-by-urls): Full posts for a list of URLs. Argument: urls (required).
• X Post By ID (x-post-by-id): One post by ID. Argument: id (required).
• X Posts By User (x-posts-by-user): Posts by a user. Arguments: user (required), query (optional), count (optional, 1–100).
• X Post Retweeters (x-post-retweeters): Users who retweeted a post. Arguments: id (required), cursor (optional).
• X User Posts (x-user-posts): A user's timeline. Arguments: username (required), cursor (optional).

The full SDK method → endpoint → MCP tool map is in docs/APIMCPPARITY.md. Every public desearch-js 1.5 method is a tool. latestTweets was removed from the SDK (GET /twitter/latest in 1.0.1) and is not exposed.

Prerequisites 📋

• An Desearch API Key
• Node.js (v20.18.1 or higher; Node 22 is supported. Node 18 is not.)
• Claude Desktop installed
• Cursor IDE

Installation 🛠️

NPM Installation

The package name is desearch-mcp-server. The first npm publish of this tree is 0.1.2 (the registry still has 0.0.1). See CHANGELOG.md for the 0.0.1 → 0.1.2 migration. The stdio entry is the desearch-mcp-server bin (build/index.js), which requires DESEARCHAPIKEY.

npm install -g desearch-mcp-server

Or run it without a global install:

Shortened. The full README is on GitHub.