DeepSearch MCP Server

Research a person's public online footprint from a name, phone number, email address, orusername — ranked candidate people with confidence scores, then a dossier with a linkedsource for every detail. Public sources only.

DeepSearch is a hosted remote MCP server. There is nothing to install or run: pointyour client at https://deepsearch.app/api/mcp and authorize.

Endpoint: https://deepsearch.app/api/mcp
Transport: Streamable HTTP (stateless)
Protocol: MCP 2025-06-18
Auth: OAuth 2.1 (dynamic client registration) or an API key as Authorization: Bearer dsk_…
Docs: https://deepsearch.app/api/docs#mcp

Tools

Tool	What it does
`search_people`	Resolves one identifier — name, phone, email, or username — to a ranked list of real, distinct people, each with a confidence score. Separates same-name individuals into candidates you can choose between, rather than returning pages to reconcile yourself.
`build_dossier`	Assembles one person's entire public footprint into a single sourced profile: identity, contact details, social accounts unified across platforms, work history, education, relatives, locations, and web mentions — every claim linked to the page it came from.
`ask_about_person`	Answers one specific question about a person, grounded in their public footprint, and suggests follow-ups. Cheaper and more direct than a full dossier when you want a single fact.

All three tools are read-only (readOnlyHint: true, destructiveHint: false) and touch theopen web (openWorldHint: true). None of them mutate anything.

Scopes map one-to-one onto the tools: search, dossier, chat.

Install

Cursor / Grok Bot plugin

This repository is a single-plugin Cursor package. After marketplace review itlists as Deep Search (not the kebab-case id) with the official logo.

In Cursor, open Customize and install Deep Search from theMarketplace. In Grok Bot, open Pluginsand add Deep Search.
Authorize with OAuth when prompted. No API key or plugin variable isrequired — the hosted server uses OAuth 2.1.

Until the listing is live, load the plugin locally and reload Cursor(Developer: Reload Window):

git clone https://github.com/Reload-Apps/deepsearch-mcp.git ~/.cursor/plugins/local/deep-search

Or copy / symlink an existing checkout into ~/.cursor/plugins/local/deep-search.Publishers submit this repo atcursor.com/marketplace/publish.

To add the hosted MCP server without the plugin, use the client configs below.

Claude Code / Cowork plugin

This repository is also a Claude Code plugin (.claude-plugin/plugin.json).After directory review it lists as Deep Search in theClaude plugin directory for Cowork and Claude Code.

In Claude Code, open /plugin and install Deep Search. In Cowork, openPlugins and add Deep Search.
Authorize with OAuth when prompted (/mcp in Claude Code). No API key isrequired — the hosted server uses OAuth 2.1 with dynamic client registration.

Until the listing is live, load this checkout as a plugin directory:

claude --plugin-dir /path/to/deepsearch-mcp

Publishers submit this repo atplatform.claude.com/plugins/submit.Validate locally with claude plugin validate . (see SETUP.md).

To add the hosted MCP server without the plugin:

claude mcp add --transport http deepsearch https://deepsearch.app/api/mcp

Claude Desktop / any client reading `claude_desktop_config.json`

{
  "mcpServers": {
    "deepsearch": {
      "type": "http",
      "url": "https://deepsearch.app/api/mcp"
    }
  }
}

Cursor — `.cursor/mcp.json`

{
  "mcpServers": {
    "deepsearch": {
      "url": "https://deepsearch.app/api/mcp"
    }
  }
}

VS Code — `.vscode/mcp.json`

{
  "servers": {
    "deepsearch": {
      "type": "http",
      "url": "https://deepsearch.app/api/mcp"
    }
  }
}

Authentication

The server advertises the standard OAuth flow, so most clients need no configuration —they discover it from the WWW-Authenticate challenge and/.well-known/oauth-protected-resource,then run dynamic client registration.

To use an API key instead, create one at https://deepsearch.app/api and send it asAuthorization: Bearer dsk_….

A 401 means the token is missing, expired, or invalid — refresh or re-authorize, thenretry. A 403 means the token is missing a scope the tool requires.

DeepSearch cannot be billed to an agent directly. If a tool result says the user must signin, subscribe, or add credits, relay that message and its URL to the user, then retry.

Discovery documents

Path	Contents
`/.well-known/mcp.json`	Server manifest with the full tool list
`/.well-known/mcp/server-card.json`	Server card
`/.well-known/oauth-protected-resource`	Resource metadata, scopes, transport
`/.well-known/oauth-authorization-server`	Authorization server metadata

server.json in this repo is theofficial MCP Registry manifest forapp.deepsearch/deepsearch.

SDKs

Prefer plain HTTP? The Developer API has dependency-free clients:

npm i @reloadapp/deepsearch-client   # TypeScript client
npm i -g @reloadapp/deepsearch-cli   # CLI

Acceptable use

DeepSearch searches public sources only. It is built for recruiting checks, sales andpartner diligence, journalism, and reconnecting with people.

It must not be used for surveillance, stalking, or harassment, and must not be usedto make employment, credit, housing, or insurance decisions. DeepSearch is not a consumerreporting agency and its output is not a consumer report.

People can remove themselves at https://deepsearch.app/remove-my-info.

License

MIT — see LICENSE. The hosted service itself is proprietary; this repositorycovers the Cursor plugin, Claude Code plugin, MCP Registry manifest, documentation, and client configuration.

DeepSearch MCP Server