Nose for Leads

Nose for Leads — Servidor MCP

Clientes potenciales de negocios locales verificados, diseñados para agentes.

Nose for Leads es un servidor MCP que encuentra, filtra y verifica clientes potenciales de negocios locales bajo demanda: los agentes reciben una lista de contactos lista para enviar, no datos de scraping en bruto. Cada correo lleva un recibo de verificación legible por máquina (verificador, veredicto, marca de tiempo) para que un agente pueda actuar sin necesidad de que un humano lo revise. El acceso se basa en créditos con presupuestos de gasto por clave y límites diarios, por lo que se puede entregar una clave a un agente sin un cheque en blanco.

• Endpoint: https://api.noseforleads.com/mcp (HTTP transmisible; OAuth 2.1 con registro dinámico de clientes, o un encabezado X-API-Key)
• Sitio web: https://www.noseforleads.com/mcp-server-local-business-leads
• Guía completa para agentes: https://www.noseforleads.com/agents.md
• OpenAPI (superficie REST): https://api.noseforleads.com/openapi.json
• Registro (25 clientes potenciales validados gratis): https://app.noseforleads.com/signup

Este repositorio contiene la documentación pública de integración, el manifiesto de registro (server.json) y transcripciones de ejemplo. El servidor está alojado de forma remota; no hay nada que instalar ni autoalojar.

Conectar

Claude Code (OAuth, sin necesidad de pegar clave)

claude mcp add --transport http nose-for-leads https://api.noseforleads.com/mcp
claude mcp login nose-for-leads

login abre tu navegador para aprobar el acceso y establecer un presupuesto de gasto. El token persiste entre sesiones y se renueva solo.

Codex CLI

# ~/.codex/config.toml
[mcp_servers.nose-for-leads]
url = "https://api.noseforleads.com/mcp"

codex mcp login nose-for-leads

Si OAuth te da problemas, el encabezado de clave API también funciona en Codex: env_http_headers = { "X-API-Key" = "YOUR_ENV_VAR" } bajo el mismo bloque.

Cursor, Windsurf, otros clientes MCP

Apunta la configuración del servidor HTTP de tu cliente a https://api.noseforleads.com/mcp. El .cursor/mcp.json de Cursor (y cualquier cliente que lea la forma estándar):

{
  "mcpServers": {
    "nose-for-leads": { "type": "http", "url": "https://api.noseforleads.com/mcp" }
  }
}

Clientes solo stdio (shim mcp-remote)

Los clientes que solo hablan stdio pueden usar el proxy estándar mcp-remote:

npx -y mcp-remote https://api.noseforleads.com/mcp

El Dockerfile del repositorio empaqueta el mismo shim (docker build -t nose-for-leads-mcp . && docker run -i nose-for-leads-mcp). Listar herramientas funciona sin autenticación; las llamadas a herramientas activan el flujo OAuth (o pasa el encabezado de clave API mediante --header "X-API-Key: ...").

Clave API (scripts, CI, clientes sin OAuth)

Genera una clave en https://app.noseforleads.com/keys y pásala como encabezado: X-API-Key: <your key> (o Authorization: Bearer <your key>). Las claves pueden llevar un presupuesto de crédito total y/o diario, por lo que un bucle descontrolado se detiene en el límite con un error budget_exhausted en lugar de agotar la cuenta.

Herramientas

Las 9 herramientas llevan anotaciones de herramienta MCP (readOnly / destructive / idempotent / openWorld) y requieren la autenticación anterior.

Herramienta	Qué hace
translate_icp	Convierte una descripción de ICP en texto libre (p. ej., "plomeros en phoenix sin sitio web") en el dict estructurado query que start_campaign requiere. Llama a esto primero: start_campaign nunca acepta texto libre.
start_campaign	Envía una campaña de clientes potenciales para una vertical + geo. Cuesta 1 crédito por cliente potencial validado y no puede gastar de más. Acepta un idempotency_key para reintentos seguros. Devuelve {job_id, idempotent_replay}.
get_campaign_status	Verifica el estado de una campaña por job_id: queued, running, done, done_partial o failed.
fetch_results	Recorre las páginas de clientes potenciales de una campaña (offset/limit). kept_only=true devuelve solo los clientes potenciales marcados como conservados en la revisión. Las filas llevan recibos de verificación cuando existe una verificación en vivo.
get_icp_pack	Lista las plantillas guardadas de vertical/geo (paquetes ICP) disponibles para la cuenta.
add_suppression	Agrega un correo o dominio a la lista de supresión para que futuras campañas lo excluyan.
review_lead	Marca un cliente potencial como kept, discarded o unreviewed.
get_credits	Verifica el saldo de crédito prepagado (1 crédito = 1 cliente potencial validado), los paquetes disponibles y las entradas recientes del libro mayor; con una clave API, también el presupuesto restante de esa clave.
send_feedback	Envía comentarios al equipo de Nose for Leads (kind: "product" o kind: "tool").

Recibos de verificación

Las filas devueltas por fetch_results llevan un recibo cuando existe una verificación en vivo: verified_by (qué verificador), verified_at (cuándo) y verifier_verdict (el resultado). Un recibo demuestra que el correo se verificó contra el proveedor de buzón en vivo, no solo mediante coincidencia de patrones. Consulta examples/ para ver formas reales de transcripción.

Créditos y semántica de seguridad

• 1 crédito = 1 cliente potencial validado; 25 gratis al registrarse, paquetes prepagados desde $19.99 por 200.
• Una campaña que descubre más clientes potenciales de los que cubre el saldo entrega lo que los créditos cubren y termina done_partial en lugar de fallar.
• Los presupuestos por clave se aplican antes del saldo de la cuenta, y start_campaign respeta idempotency_key, por lo que un reintento nunca cobra dos veces.
• Los errores devuelven un sobre {code, message} simple (p. ej., payment_required, budget_exhausted, quota_exceeded con retry_after). La tabla completa está en la guía para agentes.