All MCP Servers
Dev Tools & GitMCP Registrynpm14 toolsA · 82

Desearch MCP server

io.github.Desearch-ai · Updated

AI, X and web search, page extraction, X data, People Search, and Company Search.

At a glance

Desearch is an MCP server in the Dev Tools & Git category. It runs locally over stdio via `npx -y desearch-mcp-server`, and needs DESEARCH_API_KEY and x-api-key. It exposes 14 tools, including people-search, people-search-pause and youtube. It scores A (82/100) on the MCP Skills Hub health score as of Oct 28, 2026.

Source 1GitHub stars

One-click install

Opens your editor and pre-fills the config. Your editor will ask before adding it.

How to install Desearch in your AI client

Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.

How to install Desearch in Claude CodeAnthropic's agentic CLI

  1. Add the server

    bash
    claude mcp add mcp-desearch -e 'DESEARCH_API_KEY=<DESEARCH_API_KEY>' -- npx -y desearch-mcp-server
  2. Fill in your credentials

    Replace <DESEARCH_API_KEY>, <X-API-KEY> with your real values. Keep secrets out of any config file you commit.

  3. Verify it's connected

    bash
    claude mcp list
  4. Sharing it with your team?

    Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).

  5. Use it in a session

    Ask Claude to use the tools this server exposes (e.g. people-search, people-search-pause, youtube). It discovers them automatically.

What does Desearch need from you?

API key — Desearch API key from https://console.desearch.ai/api-keys

  • DESEARCH_API_KEYrequiredsecretEnvironment variable

    Desearch API key from https://console.desearch.ai/api-keys

  • x-api-keyoptionalsecretHTTP header

    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.

Pass secrets through your shell environment rather than committing them into a config file.

What tools does Desearch expose? (14)

Taken from the project's README — the server itself was not queried, so check its docs for the exact schemas.

  • people-searchstarts a paid job billed to the user's Desearch balance and returns a `task_id` at once. It is the only billed People Search call. It reserves `count` people at the platform's per-person price (`reserved_cost_usd`). When the search ends you
  • people-search-pause, `people-search-resume`, and `people-search-cancel` pause, resume, or cancel it. A cancelled search bills only the people it already delivered.
  • youtube`min_subscribers`, `max_subscribers`, `countries`, `require_contact`, `keywords`, `exclude_keywords`
  • linkedin`min_followers`, `max_followers`, `countries`, `keywords`, `exclude_keywords`
  • tiktok`min_followers`, `max_followers`, `require_contact`, `keywords`, `exclude_keywords`
  • completion_reasonis one of `count_reached`, `rounds_exhausted`, `no_candidates`, `zero_qualified`, `candidate_budget`, `cost_limit`, `time_limit`, `cancelled`, or `failed`. It is left out while the search runs.
  • coverage_limitedappears (as `true`) only when a budget stopped the search before it found `count` people. The status is still `completed`.
  • warningslists what made part of the search less reliable. `partial_enrichment`: `failed` of `attempted` profiles could not be read after search, so those people were scored on the search hit and show `enrichment: "failed"` with `enrichment_error`.
  • fully_verifiedis `true` when every criterion is confirmed by the person's own profile or posts. `unverified_criteria` lists up to five that are not: `(unknown)`, `(not met)`, or a disqualifier that `(applies)`. Both are information only: the person still
  • company-searchor `company-enrich` starts a paid job billed to the user's Desearch balance and returns a `task_id` at once. Company Search reserves `count` companies at its per-company price, Company Enrich one company per domain sent at its own price (pr
  • company-search-statusreturns the task's status, progress, cost, and a page of companies. Each company goes through stages: `profile` (its homepage, and the fit score), `contacts` (its contact, about, team, and imprint pages), `people` (its leaders), `email_patt
  • company-search-pause, `company-search-resume`, and `company-search-cancel` pause, resume, or cancel it. `company-search-tasks` lists your tasks, filtered by `type` (`search` or `enrich`), `status`, or `metadata`.
  • scoreis the fit score (0–100) for Company Search and `null` for Company Enrich. `why` and up to three `reasons` say why it matched; `fully_verified` and `unverified_criteria` say what the company's own pages confirm (information only: the compan
  • primary_emailis never a `support`, `legal`, `careers`, `press`, or `other` address, and an inferred one only when `valid`. `primary_contact` is the leader to reach first, with why.

What the code can do

Read from the published package source — never executed. Parsed 23 of 23 source files.

This server can make network requests and read your environment variables.

How it was published

  • Published by a verified CI identity (github trusted publishing) rather than a personal token.
  • Has a provenance attestation tying this artifact to the commit it was built from.
  • 1 npm maintainer — a single point of compromise · last published by GitHub Actions.

Maintainer of this package and think something here is wrong? Tell us and we'll correct it.

Before you install

Signals gathered from the source repo and package registry — not a safety verdict.

What it can reach

  • Runs code on your machine — Executes as a local process with your user's permissions, including filesystem access.
  • Downloads at launch — The package is fetched from its registry each run unless you pin a version.
  • Last commit today — Actively maintained.
  • 1 GitHub stars — Very little community usage so far.

Client compatibility

Claude Code: NativeClaude Desktop: NativeCursor: NativeCodex CLI: NativeWindsurf: NativeCline: NativeVS Code: Native

Health score

A · 82

Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated

  • Maintenance30%100%

    Last commit 0 days ago.

  • Adoption20%9%

    1 stars.

  • Transparency20%100%

    4/4: ✓ public source repo, ✓ declared license, ✓ documentation, ✓ discoverable tool list.

  • Provenance15%100%

    Package and registry entry point at the same repository.

  • Packaging15%100%

    Publishes a pinned version (0.6.0).

Documentation

Full README

Desearch MCP Server

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

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

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

Get a key.

Find Desearch on

Demo

Prompt: Search the web for latest news on AI.

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

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

Example output:

json
{
    "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": "<json above>" }] }.

Excerpt — the full document is on GitHub.

Maintain Desearch? Add a badge to your README

Shows its health grade, and links readers to install steps for every client.

markdown
[![Desearch on MCP Skills Hub](https://mcp-skills-hub.vercel.app/badge/io-github-desearch-ai-mcp-desearch)](https://mcp-skills-hub.vercel.app/mcps/io-github-desearch-ai-mcp-desearch)

Catalog data refreshed . Something wrong? Report it.