ProspectAPIs MCP

prospectapis-mcp

Servidor MCP para la API de datos e investigación de financiamiento de ProspectAPIs. Proporciona a un cliente MCP (Claude Desktop, Claude Code, Cursor y otros) catorce herramientas sobre https://api.prospectapis.com, una por endpoint de cliente (la sonda de actividad GET /health no tiene ninguna; api_version responde la misma pregunta). Cinco herramientas cambian estado: research_submit (inicia un trabajo de investigación pagado), watchlist_create, watchlist_test, watchlist_delete y feedback_send; todas las demás herramientas solo leen.

Herramienta	Endpoint	Costo
funding_search	GET /v1/funding	$0.02 por registro devuelto, después de 100 registros gratuitos al mes; sin coincidencia es gratuito
funding_get	GET /v1/funding/:id	$0.02 cuando se encuentra; un id faltante es gratuito
research_submit	POST /v1/research	una investigación en research_price_usd (ver account_balance), cobrada solo cuando el informe se completa; reembolsada en caso de fallo
research_get	GET /v1/research/:id	gratuito; consultar hasta que status sea completed o failed
watchlist_create, watchlist_list, watchlist_get, watchlist_deliveries, watchlist_test, watchlist_delete	/v1/watchlists	gratuito para gestionar; un evento entregado cuesta un registro, solo cuando tu webhook responde 2xx
account_balance	GET /v1/account	gratuito
feedback_send	POST /v1/feedback	gratuito; reporta un error, campo incorrecto o capacidad faltante al equipo (10 por hora por clave)
pricing_get	GET /pricing	gratuito, sin clave necesaria; la lista de precios en vivo
api_version	GET /v1/version	gratuito, sin clave necesaria

Filtros de funding_search: since, until (AAAA-MM-DD), round (lista separada por comas como seed,series_a), min_amount_usd, max_amount_usd, company, domain, investor, country, limit (1 a 100) y cursor (el next_cursor de la página anterior, pasado de vuelta sin cambios).

research_submit toma exactamente un identificador de prospecto (domain, website_url, company_name, company_linkedin_url, un email de trabajo o linkedin_url), o person_name con company_name, más un context opcional (tu propio producto, como máximo 1,000 caracteres) y purpose (account_research, pre_call o outreach). Devuelve un research_id de inmediato; un informe tarda de 20 a 90 segundos.

Configurar

Variable	Requerida	Predeterminado
PROSPECTAPIS_API_KEY	sí (todas las herramientas excepto pricing_get y api_version)	ninguna
PROSPECTAPIS_BASE_URL	no	https://api.prospectapis.com

Configuración del cliente (por ejemplo, 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.

Desarrollar

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

El paquete tiene versión independiente de la API (SemVer, CHANGELOG.md en esta carpeta). Está marcado como private para que no pueda publicarse por accidente; la publicación se realiza solo desde la identidad npm propia del producto.