ProspectAPIs MCP

prospectapis-mcp

Servidor MCP para a API de dados e pesquisa de financiamento da ProspectAPIs. Ele fornece a um cliente MCP (Claude Desktop, Claude Code, Cursor e outros) quatorze ferramentas via https://api.prospectapis.com, uma por endpoint de cliente (a sonda de liveness GET /health não possui nenhuma; api_version responde à mesma pergunta). Cinco ferramentas alteram estado: research_submit (inicia um trabalho de pesquisa pago), watchlist_create, watchlist_test, watchlist_delete e feedback_send; todas as outras ferramentas apenas leem.

Ferramenta	Endpoint	Custo
funding_search	GET /v1/funding	$0,02 por registro retornado, após 100 registros gratuitos por mês; nenhuma correspondência é gratuita
funding_get	GET /v1/funding/:id	$0,02 quando encontrado; um id ausente é gratuito
research_submit	POST /v1/research	uma pesquisa em research_price_usd (veja account_balance), cobrada somente quando o briefing é concluído; reembolsada em caso de falha
research_get	GET /v1/research/:id	gratuito; faça polling até que status seja completed ou failed
watchlist_create, watchlist_list, watchlist_get, watchlist_deliveries, watchlist_test, watchlist_delete	/v1/watchlists	gratuito para gerenciar; um evento entregue custa um registro, somente quando seu webhook responde com 2xx
account_balance	GET /v1/account	gratuito
feedback_send	POST /v1/feedback	gratuito; reporta um bug, campo incorreto ou funcionalidade ausente à equipe (10 por hora por chave)
pricing_get	GET /pricing	gratuito, sem necessidade de chave; a lista de preços ao vivo
api_version	GET /v1/version	gratuito, sem necessidade de chave

Filtros do funding_search: since, until (AAAA-MM-DD), round (lista separada por vírgulas, como seed,series_a), min_amount_usd, max_amount_usd, company, domain, investor, country, limit (1 a 100) e cursor (o next_cursor da página anterior, passado de volta inalterado).

research_submit aceita exatamente um identificador de prospect (domain, website_url, company_name, company_linkedin_url, um email de trabalho ou linkedin_url), ou person_name com company_name, além de um context opcional (seu próprio produto, com no máximo 1.000 caracteres) e purpose (account_research, pre_call ou outreach). Ele retorna um research_id imediatamente; um briefing leva de 20 a 90 segundos.

Configurar

Variável	Obrigatória	Padrão
PROSPECTAPIS_API_KEY	sim (todas as ferramentas, exceto pricing_get e api_version)	nenhum
PROSPECTAPIS_BASE_URL	não	https://api.prospectapis.com

Configuração do cliente (por exemplo, claude_desktop_config.json):

{
  "mcpServers": {
    "prospectapis": {
      "command": "npx",
      "args": ["-y", "prospectapis-mcp"],
      "env": { "PROSPECTAPIS_API_KEY": "pa_live_..." }
    }
  }
}

Claude Code: claude mcp add prospectapis -e PROSPECTAPIS_API_KEY=pa_live_... -- npx -y prospectapis-mcp.

Desenvolver

cd mcp
npm install
npm test        # mocked fetch over an in-memory MCP transport, no network
npm run check

O pacote é versionado independentemente da API (SemVer, CHANGELOG.md nesta pasta). Ele está marcado como private para que não possa ser publicado acidentalmente; a publicação é feita somente a partir da identidade npm do próprio produto.