DeepSearch

Servidor MCP DeepSearch

Pesquise a pegada pública online de uma pessoa a partir de um nome, número de telefone, endereço de e-mail ou nome de usuário — candidatos ranqueados com pontuações de confiança e, em seguida, um dossiê com uma fonte vinculada para cada detalhe. Somente fontes públicas.

DeepSearch é um servidor MCP remoto hospedado. Não há nada para instalar ou executar: aponte seu cliente para https://deepsearch.app/api/mcp e autorize.

• Endpoint: https://deepsearch.app/api/mcp
• Transporte: Streamable HTTP (sem estado)
• Protocolo: MCP 2025-06-18
• Autenticação: OAuth 2.1 (registro dinâmico de cliente) ou uma chave de API como Authorization: Bearer dsk_…
• Documentação: https://deepsearch.app/api/docs#mcp

Ferramentas

Ferramenta	O que faz
search_people	Resolve um identificador — nome, telefone, e-mail ou nome de usuário — para uma lista ranqueada de pessoas reais e distintas, cada uma com uma pontuação de confiança. Separa indivíduos com o mesmo nome em candidatos entre os quais você pode escolher, em vez de retornar páginas para você reconciliar por conta própria.
build_dossier	Reúne toda a pegada pública de uma pessoa em um único perfil com fontes: identidade, dados de contato, contas sociais unificadas entre plataformas, histórico profissional, educação, parentes, locais e menções na web — cada afirmação vinculada à página de onde veio.
ask_about_person	Responde a uma pergunta específica sobre uma pessoa, com base em sua pegada pública, e sugere acompanhamentos. Mais barato e mais direto do que um dossiê completo quando você quer um único fato.

Todas as três ferramentas são somente leitura (readOnlyHint: true, destructiveHint: false) e acessam a web aberta (openWorldHint: true). Nenhuma delas altera nada.

Os escopos mapeiam um a um para as ferramentas: search, dossier, chat.

Instalação

Plugin Cursor / Grok Bot

Este repositório é um pacote Cursor de plugin único. Após a revisão do marketplace, ele aparece como Deep Search (não o id em kebab-case) com o logotipo oficial.

1. No Cursor, abra Customize e instale Deep Search no Marketplace. No Grok Bot, abra Plugins e adicione Deep Search.
2. Autorize com OAuth quando solicitado. Nenhuma chave de API ou variável de plugin é necessária — o servidor hospedado usa OAuth 2.1.

Até a listagem ficar ativa, carregue o plugin localmente e recarregue o Cursor (Developer: Reload Window):

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

Ou copie / crie um link simbólico de um checkout existente em ~/.cursor/plugins/local/deep-search. Os editores enviam este repositório em cursor.com/marketplace/publish.

Para adicionar o servidor MCP hospedado sem o plugin, use as configurações de cliente abaixo.

Plugin Claude Code / Cowork

Este repositório também é um plugin Claude Code (.claude-plugin/plugin.json). Após a revisão do diretório, ele aparece como Deep Search no diretório de plugins Claude para Cowork e Claude Code.

1. No Claude Code, abra /plugin e instale Deep Search. No Cowork, abra Plugins e adicione Deep Search.
2. Autorize com OAuth quando solicitado (/mcp no Claude Code). Nenhuma chave de API é necessária — o servidor hospedado usa OAuth 2.1 com registro dinâmico de cliente.

Até a listagem ficar ativa, carregue este checkout como um diretório de plugin:

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

Os editores enviam este repositório em platform.claude.com/plugins/submit. Valide localmente com claude plugin validate . (veja SETUP.md).

Para adicionar o servidor MCP hospedado sem o plugin:

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

Claude Desktop / qualquer cliente que leia 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"
    }
  }
}

Autenticação

O servidor anuncia o fluxo OAuth padrão, então a maioria dos clientes não precisa de configuração — eles descobrem isso a partir do desafio WWW-Authenticate e /.well-known/oauth-protected-resource, e então executam o registro dinâmico de cliente.

Para usar uma chave de API, crie uma em https://deepsearch.app/api e envie-a como Authorization: Bearer dsk_….

Um 401 significa que o token está ausente, expirado ou inválido — atualize ou reautorize e tente novamente. Um 403 significa que o token não tem um escopo que a ferramenta exige.

DeepSearch não pode ser cobrado diretamente de um agente. Se um resultado de ferramenta disser que o usuário deve entrar, assinar ou adicionar créditos, repasse essa mensagem e sua URL ao usuário e tente novamente.

Documentos de descoberta

Caminho	Conteúdo
/.well-known/mcp.json	Manifesto do servidor com a lista completa de ferramentas
/.well-known/mcp/server-card.json	Cartão do servidor
/.well-known/oauth-protected-resource	Metadados de recursos, escopos, transporte
/.well-known/oauth-authorization-server	Metadados do servidor de autorização

server.json neste repositório é o manifesto do Registro MCP oficial para app.deepsearch/deepsearch.

SDKs

Prefere HTTP simples? A API do Desenvolvedor tem clientes sem dependências:

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

Uso aceitável

DeepSearch pesquisa somente fontes públicas. Ele foi criado para verificações de recrutamento, diligência de vendas e parcerias, jornalismo e reconexão com pessoas.

Ele não deve ser usado para vigilância, perseguição ou assédio, e não deve ser usado para tomar decisões de emprego, crédito, moradia ou seguro. DeepSearch não é uma agência de relatórios ao consumidor e sua saída não é um relatório ao consumidor.

As pessoas podem se remover em https://deepsearch.app/remove-my-info.

Licença

MIT — veja LICENSE. O serviço hospedado em si é proprietário; este repositório cobre o plugin Cursor, o plugin Claude Code, o manifesto do Registro MCP, a documentação e a configuração do cliente.