{"id":"io.github.Desearch-ai/mcp-desearch","slug":"io-github-desearch-ai-mcp-desearch","title":"Desearch","description":"39 tools: AI/web/X search, TikTok, Facebook, Instagram, YouTube, Reddit, Threads, People/Companies.","version":"0.11.1","publisher":{"kind":"github","id":"Desearch-ai","label":"@Desearch-ai on GitHub","url":"https://github.com/Desearch-ai"},"website":"https://www.desearch.ai/docs/guide/sdk/mcp","repository":"https://github.com/Desearch-ai/mcp-desearch","remotes":[{"type":"streamable-http","url":"https://mcp.desearch.ai/mcp","headers":[{"description":"Desearch API key. Send this header, or connect with OAuth and paste the key on the Desearch sign-in page. Discovery does not need a key.","value":"{desearch_api_key}","isSecret":true,"variables":{"desearch_api_key":{"description":"Desearch API key from https://console.desearch.ai/api-keys","isRequired":true,"isSecret":true}},"name":"x-api-key"}]}],"packages":[{"registryType":"npm","registryBaseUrl":"https://registry.npmjs.org","identifier":"desearch-mcp-server","version":"0.11.1","transport":{"type":"stdio"},"environmentVariables":[{"description":"Desearch API key from https://console.desearch.ai/api-keys","isRequired":true,"isSecret":true,"name":"DESEARCH_API_KEY"}]}],"published":"2026-11-17","updated":"2026-11-17","status":"online","auth":"","latency_ms":960,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"ai-search","title":"AI Search","description":"AI Search over X (Twitter) posts and web (from the Desearch index), with an optional AI summary. Web results are capped at 20 per request. For web-only search, use search-api.","read_only":true},{"name":"x-search","title":"X Search","description":"Search X (Twitter) using Desearch AI. Optional filters narrow by user, date, language, verification, media, and engagement. Sort stays Top.","read_only":true},{"name":"web-search","title":"Web Search","description":"SERP-style web search using Desearch. Returns ranked titles, links, and snippets.","read_only":true},{"name":"web-links-search","title":"Web Links Search","description":"Deprecated: use search-api. Search the web for links using Desearch (POST /desearch/ai/search/links/web). Only the web source is accepted.","read_only":true},{"name":"x-links-search","title":"X Links Search","description":"AI search for X (Twitter) post links using Desearch. Returns links from posts that match the prompt.","read_only":true},{"name":"x-posts-by-urls","title":"Get X Posts by URLs","description":"Fetch full X (Twitter) posts for a list of post URLs.","read_only":true},{"name":"x-post-by-id","title":"Get X Post by ID","description":"Fetch a single X (Twitter) post by its ID.","read_only":true},{"name":"x-posts-by-user","title":"Search X Posts by User","description":"Search X (Twitter) posts by a specific user, with an optional keyword query.","read_only":true},{"name":"x-post-retweeters","title":"List X Post Retweeters","description":"List users who retweeted an X (Twitter) post. Pass cursor to page through more users.","read_only":true},{"name":"x-user-posts","title":"Get X User Timeline","description":"Retrieve a user's X (Twitter) timeline posts by username. Pass cursor to page through more posts.","read_only":true},{"name":"x-user-replies","title":"Get X User Replies","description":"Fetch posts and replies by an X (Twitter) user, with an optional keyword query.","read_only":true},{"name":"x-post-replies","title":"Get X Post Replies","description":"Fetch replies to an X (Twitter) post, with an optional keyword query.","read_only":true},{"name":"extract","title":"Extract Page Content","description":"Extract a public URL and return its content as plain text, markdown or HTML using Desearch. Markdown keeps headings, lists and tables. Text is the page's main content; set full_page for every section, such as opening hours or fee tables. A js_required error means the page needs js: true; blocked means the site refused or showed a bot check. Preferred over web-crawl for new integrations. API docs: ","read_only":true},{"name":"web-crawl","title":"Crawl Web Page (Legacy)","description":"Crawl a public URL and return its content as plain text or HTML on the legacy Desearch /web/crawl route. The SDK marks webCrawl deprecated in favor of extract; this tool stays for parity with that route. Prefer extract for new integrations. API docs: https://www.desearch.ai/docs/guide/apis/extract-api","read_only":true},{"name":"x-trends","title":"Get X Trends","description":"Retrieve trending topics on X (Twitter) for a location by its WOEID using Desearch.","read_only":true},{"name":"search-api","title":"Search API","description":"Web search on the Desearch index (POST /search). Returns ranked pages, each with its title, URL, publication date when known, and the passage that best matches the query. Set summary: true for a short answer written from the results with numbered citations; [n] in summary.text refers to summary.citations[].index. Set page_text to add each page's full text. Returns { summary, results, meta, cost_us","read_only":true},{"name":"tiktok","title":"TikTok","description":"Read public TikTok data with Desearch. Set action and that action's arguments. search (query; optional count, sort, cursor): videos that match a keyword. post (id): one video by its ID. profile (username): one profile. profile_posts (username; optional count, cursor): a user's videos. comments (video_id; optional count, cursor): a video's comments. hashtag (tag; optional count, cursor): videos wit","read_only":true},{"name":"facebook","title":"Facebook","description":"Read public Facebook data with Desearch. Set action and that action's arguments. search (query; optional count, cursor) and hashtag (tag; optional count, cursor) return Meta Ad Library ads that match, not organic posts. post (id): one public post. profile (profile_id): a page or profile by ID or public handle. profile_posts (profile_id; optional count, cursor): its posts. comments (post_id; option","read_only":true},{"name":"instagram","title":"Instagram","description":"Read public Instagram data with Desearch. Set action and that action's arguments. search (query; optional count): profiles that match, one page with no cursor. media (id): one post by shortcode, numeric ID, or URL. profile (username): one profile. profile_posts (username; optional count, cursor): a user's posts. comments (shortcode; optional count, cursor): a post's comments. hashtag (tag; optiona","read_only":true},{"name":"youtube","title":"YouTube","description":"Read public YouTube data with Desearch. Set action and that action's arguments. search (query; optional type, upload_date, sort_by, duration, cursor): videos, Shorts, live streams, channels, and playlists that match a keyword; each result has a type. video (id): one video or Short by ID or URL, with its channel, counts, chapters, and caption languages. transcript (video_id; optional language): its","read_only":true},{"name":"reddit","title":"Reddit","description":"Read public Reddit data with Desearch. Set action and that action's arguments. search (query; optional sort, timeframe, cursor): posts across all subreddits that match a keyword. subreddit (name): a subreddit's description, rules, and weekly activity; the name is case-sensitive ('AskReddit', not 'askreddit'). subreddit_posts (name; optional sort, timeframe, cursor): its posts. post (id): one post ","read_only":true},{"name":"threads","title":"Threads","description":"Read public Threads data with Desearch. Set action and that action's arguments. search (query; optional start_date, end_date): one page of posts that match a keyword. search_users (query): accounts that match a username or name. profile (username): one profile with bio, followers, and links. profile_posts (username): the account's latest public posts (Threads shows only the most recent ones). post","read_only":true},{"name":"search","title":"Search","description":"Search the public web and return titles and links. Use fetch with a result URL to read the page.","read_only":true},{"name":"fetch","title":"Fetch Page","description":"Read a public page as text. Pass a URL returned by search.","read_only":true},{"name":"people-search","title":"People Search","description":"Start a paid job billed to the user's Desearch balance: find people on X, YouTube, LinkedIn, or TikTok who match a plain-language description. Returns a task_id at once, with the task's status and reserved_cost_usd. Cost: the call reserves count times the platform's per-person price at the time of the call (reserved_cost_usd; prices at https://desearch.ai/pricing). When the search ends you pay onl","read_only":false},{"name":"people-search-status","title":"Get People Search Status","description":"Status, progress, and cost of one People Search task, plus a page of the people found so far: name, handle, url, platform, audience, location, fit score, why they matched, contacts, and links. Free: it reads a search you already started and runs no new search. Cost fields are reserved_cost_usd and, once the search ended, final_cost_usd. People come from public profiles and posts on the search's pl","read_only":true},{"name":"people-search-pause","title":"Pause People Search","description":"Pause a People Search task and return its updated status. Free: it charges and refunds nothing. A queued search pauses at once; a running one finishes its current batch first (status pausing, then paused). Pausing loses no data: the people found so far stay readable with people-search-status, and the search keeps its progress. Billing does not change: the reservation made when the search started s","read_only":false},{"name":"people-search-resume","title":"Resume People Search","description":"Resume a paused People Search task and return its updated status. Free. The search continues from where it stopped, keeping the people already found, with no new charge: the cost already spent is carried forward and the original reservation still covers it. Works only on a paused search, within 7 days of pausing; a search in any other state, including one the API cancelled after 7 days paused, ret","read_only":false},{"name":"people-search-cancel","title":"Cancel People Search","description":"Cancel a People Search task. Free. The search stops for good; you pay only for the people it already delivered and the rest of the reservation is returned. People found so far stay readable for 30 days. This cannot be undone.","read_only":false},{"name":"people-search-tasks","title":"List People Search Tasks","description":"Your People Search tasks, newest first, with status, counts, cost, why each ended search stopped (completion_reason, coverage_limited), and the metadata labels set on people-search. Free; it lists your own tasks, not the people they found (read those with people-search-status or people-profiles). Use it to find a task_id (filter by metadata to find the searches of one campaign), or to see which se","read_only":true},{"name":"people-profiles","title":"List People Found","description":"Everyone your own People Searches found on one platform, one entry per person: their best-scoring result (name, handle, url, audience, location, fit score, why they matched, public contacts, and links) and the search that found them (found_by). Free: it reads only people your earlier searches found, runs no new search, and queries no outside source. That data came from public profiles and posts, w","read_only":true},{"name":"people-search-export","title":"Export People Found","description":"The people your own People Searches found, as CSV or JSON Lines text: one search (task_id), or everyone found on one platform (platform, with the same q, sort, and filters as people-profiles). Free: it reads people your earlier searches found and runs no new search. The reply is a note with the row count, then the file text cut at a row boundary to max_rows rows and 50,000 characters; the note say","read_only":true},{"name":"company-search","title":"Company Search","description":"Start a paid job billed to the user's Desearch balance: find companies on the web that match a plain-language description, and collect each one's public contact data. Returns a task_id at once, with the task's status and reserved_cost_usd. Cost: without max_cost_usd, the call reserves count companies at the Company Search per-company price at the time of the call (reserved_cost_usd; prices at http","read_only":false},{"name":"company-enrich","title":"Company Enrich","description":"Start a paid job billed to the user's Desearch balance: collect public contact data for companies you already know, by domain. Send 1-200 domains or URLs; each is reduced to its host without www., lowercased, and deduplicated, and the task reads every one. Returns a task_id at once, with the task's status and reserved_cost_usd. You get one company per domain with the same fields as company-search ","read_only":false},{"name":"company-search-status","title":"Get Company Search Status","description":"Status, progress, and cost of one Company Search or Company Enrich task, plus a page of the companies delivered so far: domain, name, url, location, fit score (null for Company Enrich) and why it matched, primary_email and primary_contact, public emails, phones, and social profiles with the page each came from (source_url), leaders with their roles, title, LinkedIn profile, and emails (each with i","read_only":true},{"name":"company-search-pause","title":"Pause Company Search","description":"Pause a Company Search or Company Enrich task and return its updated status. Free: it charges and refunds nothing. A queued task pauses at once; a running one finishes its current batch first (status pausing, then paused). Pausing loses no data: the companies delivered so far stay readable with company-search-status, and the task keeps its progress. Billing does not change: the reservation made wh","read_only":false},{"name":"company-search-resume","title":"Resume Company Search","description":"Resume a paused Company Search or Company Enrich task and return its updated status. Free. The task continues from where it stopped, keeping the companies already delivered, with no new charge. Works only on a paused task, within 7 days of pausing; a task in any other state, including one the API cancelled after 7 days paused, returns 409. Poll company-search-status for the new companies.","read_only":false},{"name":"company-search-cancel","title":"Cancel Company Search","description":"Cancel a Company Search or Company Enrich task. Free. The task stops for good; you pay only for the companies it already delivered (a task cancelled before it starts costs nothing) and the rest of the reservation is returned. A Company Search started with max_cost_usd pays for its search effort so far instead when that is more, up to its budget. Companies delivered so far stay readable for 30 days","read_only":false},{"name":"company-search-tasks","title":"List Company Search Tasks","description":"Your Company Search and Company Enrich tasks, newest first, with status, counts, cost, why each ended task stopped (completion_reason, coverage_limited), max_cost_usd and continue_from when a search set them, and the metadata labels set on company-search or company-enrich. Free; it lists your own tasks, not the companies they found (read those with company-search-status). People Search tasks are n","read_only":true}],"server_info":{"name":"Desearch","version":"0.11.1","title":"Desearch","websiteUrl":"https://www.desearch.ai","icons":[{"src":"https://mcp.desearch.ai/icon-512.png","mimeType":"image/png","sizes":["512x512"]},{"src":"https://mcp.desearch.ai/icon-64.png","mimeType":"image/png","sizes":["64x64"]}]},"category":"web-search","tags":["social","hr","productivity"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-01","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-desearch-ai-mcp-desearch/"}