Desearch

Desearch MCP Server

If Desearch is useful, a star helps others find it.

Remote: https://mcp.desearch.ai/mcp with header Authorization: Bearer .

Local: npx -y desearch-mcp-server@latest with env DESEARCH_API_KEY.

Get a key.

Find Desearch on

• Official MCP Registry
• Smithery
• Glama
• VoltAgent official MCP servers
• Gemini CLI extensions
• Raycast MCP Registry

Demo

Prompt: Search the web for latest news on AI.

web-search takes query (required) and start (optional pagination offset: 0, 10, 20, ...).

{

"name": "web-search", "arguments": { "query": "latest news on AI" } }

Example output:

{

"data": [ { "title": "Example result", "link": "https://example.com/page", "snippet": "Short preview text." } ] }

The tool returns that JSON as pretty-printed text: { "content": [{ "type": "text", "text": " " }] }.

AI search, X search and web search for AI agents, plus the Search API (ranked pages with the best-matching passage), page extraction, X data tools, public TikTok, Facebook, Instagram, YouTube (videos, transcripts, comments, channels), Reddit, and Threads data, People Search (find people and creators on X, YouTube, LinkedIn, and TikTok), and Company Search (find companies on the web, or enrich domains you have, with their public contacts and leaders). Bring your own Desearch API key. Version 0.9.0 exposes 39 tools.

Tools

The Desearch MCP server includes the following tools.

Lookup tools, including search and fetch, set readOnlyHint: true, destructiveHint: false, and openWorldHint: true. search-api, tiktok, facebook, instagram, youtube, reddit, threads, people-search-status, people-search-tasks, people-profiles, and people-search-export are lookups too. people-search starts a paid job billed to the user's Desearch balance, so readOnlyHint is false; it creates a new task and does not delete or overwrite anything, so destructiveHint is false. people-search-pause and people-search-resume change a task's state and undo each other, so readOnlyHint and destructiveHint are false and idempotentHint is true. Pausing loses no data (people found so far stay readable and the search keeps its progress) and changes no billing (nothing is charged or refunded; the reservation stays until the search ends), and resume continues from where the search stopped with no new charge. The caveat: the API cancels a search paused for more than 7 days, and a cancelled search cannot be resumed, so a pause is reversible only within those 7 days. people-search-cancel cannot be undone, so readOnlyHint is false and destructiveHint and idempotentHint are true. The Company Search tools follow the same rules: company-search and company-enrich start paid jobs (readOnlyHint: false, destructiveHint: false, idempotentHint: false), company-search-status and company-search-tasks are lookups, company-search-pause and company-search-resume set destructiveHint: false and idempotentHint: true (with the same 7-day caveat), and company-search-cancel sets destructiveHint: true and idempotentHint: true. openWorldHint is true on every tool because the call reaches a live external source.

• AI Search (ai-search): Performs AI Twitter and web searches with relevant links and summary. tools uses short source ids (web, twitter, arxiv, wikipedia, hackernews, reddit). Older labels such as Web Search, ArXiv Search, Wikipedia Search, Hacker News Search, and Reddit Search are still accepted and sent as the short id. youtube is not accepted. Default is ["web", "twitter"].
• X Search (x-search): Tweet search on X. Arguments: query (required), count (optional, default 20). Sort stays Top. Optional filters: user, start_date, end_date (YYYY-MM-DD), lang, verified, blue_verified, is_quote, is_video, is_image, min_retweets, min_replies, min_likes.
• Search (search): Web search that returns { results: [{ id, title, url }] }. Argument: query (required). id is the result URL.
• Fetch Page (fetch): Read a public page as text. Argument: id (required, an http or https URL from search).
• Web Search (web-search): SERP-style web search. Arguments: query (required), start (optional pagination offset).
• Search API (search-api): Ranked web pages, each with its title, URL, publication date when known, and the passage that best matches the query (POST /search). Arguments: query (required, 1–2000 characters), mode (optional, fast or balanced, API default balanced), count (optional, 10, 15, or 20), start_date and end_date (optional, YYYY-MM-DD), highlights (optional, default true), page_text (optional, default false; adds each page's full text). Returns results plus cost_usd, usage_count, service, and currency.
• 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, text, markdown or html), js (optional), wait (optional milliseconds), full_page (optional, text only: every visible section of the page instead of its main content). Errors carry an error_code: js_required (retry with js: true), blocked (the site refused or showed a bot check), page_not_found.
• 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).
• X User Replies (x-user-replies): Posts and replies by a user. Arguments: user (required), count (optional, 1–100), query (optional).
• X Post Replies (x-post-replies): Replies to a post. Arguments: post_id (required), count (optional, 1–100), query (optional).
• X Trends (x-trends): Trending topics for a location. Arguments: woeid (required), count (optional, 30–100).
• TikTok (tiktok): Public TikTok data. action (required) picks the route: search (query; optional count, sort, cursor), post (id), profile (username), profile_posts (username; optional count, cursor), comments (video_id; optional count, cursor), hashtag (tag; optional count, cursor), trending (optional region, count). See TikTok, Facebook, and Instagram.
• Facebook (facebook): Public Facebook data. action (required): search (query; optional count, cursor) and hashtag (tag; optional count, cursor) return Meta Ad Library ads, not organic posts; post (id), profile (profile_id, a page or profile ID or public handle), profile_posts (profile_id; optional count, cursor), comments (post_id; optional count, cursor).
• Instagram (instagram): Public Instagram data. action (required): search (query; optional count; profiles, one page, no cursor), media (id: shortcode, numeric ID, or URL), profile (username), profile_posts (username; optional count, cursor), comments (shortcode, the code in the post URL; optional count, cursor), hashtag (tag; optional count, cursor).
• YouTube (youtube): Public YouTube data. action (required): search (query; optional type, upload_date, sort_by, duration, cursor; videos, Shorts, live streams, channels, and playlists, each with a type), video (id: video or Short ID or URL), transcript (video_id; optional language), comments (video_id; optional order, cursor), channel (handle, with or without @, or a UC... channel ID), channel_videos (handle; optional sort, cursor). See YouTube, Reddit, and Threads.
• Reddit (reddit): Public Reddit data. action (required): search (query; optional sort, timeframe, cursor), subreddit (name, case-sensitive), subreddit_posts (name; optional sort, timeframe, cursor), post (id: post ID or URL), comments (post_id; optional cursor).
• Threads (threads): Public Threads data. action (required): search (query; optional start_date, end_date), search_users (query), profile (username), profile_posts (username), post (id: post URL or shortcode). One page each; no cursor.
• People Search (people-search): Start a paid job billed to the user's Desearch balance: a search for people who match a plain-language description. Arguments: platform (required: x, youtube, linkedin, or tiktok), query (required, 3–1000 characters), count (optional, 5–200, API default 25), min_score (optional, 0–100), exclude (optional handles), metadata (optional labels, below), idempotency_key (optional), and that platform's filters (below). Returns the task_id, status, and reserved_cost_usd (count times the platform's per-person price at the time of the call; prices at https://desearch.ai/pricing); the ended task carries final_cost_usd. Public data only: public X posts and profile fields, public YouTube channel pages plus the creator's own website for publicly listed contact details, public LinkedIn posts and profiles, and public TikTok videos and profiles. Contacts are only those the person lists publicly.
• People Search Status (people-search-status): A task's status, progress, and cost, plus a page of the people found so far. Arguments: task_id (required), cursor (optional, next_cursor from the previous call), limit (optional, 1–100, default 25), include_people (optional, default true). Free; it reads a search you already started (people come from public profiles and posts).
• Pause People Search (people-search-pause): Pause a task. A queued search pauses at once; a running one finishes its current batch first. No data is lost and billing does not change; people-search-resume continues wher