Nose for Leads

Nose for Leads — servidor MCP

Leads verificados de negócios locais, feitos para agentes.

O Nose for Leads é um servidor MCP que encontra, filtra e verifica leads de negócios locais sob demanda: os agentes recebem uma lista de contatos pronta para envio, não dados brutos de scraping. Cada e-mail carrega um recibo de verificação legível por máquina (verificador, veredito, timestamp) para que um agente possa agir sem que um humano precise conferir novamente. O acesso é baseado em créditos, com orçamentos de gasto por chave e limites diários, para que um agente possa receber uma chave sem um cheque em branco.

• Endpoint: https://api.noseforleads.com/mcp (HTTP streamable; OAuth 2.1 com registro dinâmico de clientes, ou um cabeçalho X-API-Key)
• Site: https://www.noseforleads.com/mcp-server-local-business-leads
• Guia completo para agentes: https://www.noseforleads.com/agents.md
• OpenAPI (superfície REST): https://api.noseforleads.com/openapi.json
• Cadastre-se (25 leads validados grátis): https://app.noseforleads.com/signup

Este repositório contém a documentação pública de integração, o manifesto de registro (server.json) e transcrições de exemplo. O servidor em si é hospedado remotamente; não há nada para instalar ou hospedar por conta própria.

Conectar

Claude Code (OAuth, sem chave para colar)

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

login abre seu navegador para aprovar o acesso e definir um orçamento de gastos. O token persiste entre sessões e se renova automaticamente.

Codex CLI

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

codex mcp login nose-for-leads

Se o OAuth der problema, o cabeçalho de chave de API também funciona no Codex: env_http_headers = { "X-API-Key" = "YOUR_ENV_VAR" } no mesmo bloco.

Cursor, Windsurf, outros clientes MCP

Aponte a configuração do servidor HTTP do seu cliente para https://api.noseforleads.com/mcp. O .cursor/mcp.json do Cursor (e qualquer cliente que leia o formato padrão):

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

Clientes somente stdio (shim mcp-remote)

Clientes que só falam stdio podem usar o proxy padrão mcp-remote:

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

O Dockerfile do repositório empacota o mesmo shim (docker build -t nose-for-leads-mcp . && docker run -i nose-for-leads-mcp). Listar ferramentas funciona sem autenticação; chamadas de ferramentas disparam o fluxo OAuth (ou passam o cabeçalho de chave de API via --header "X-API-Key: ...").

Chave de API (scripts, CI, clientes sem OAuth)

Crie uma chave em https://app.noseforleads.com/keys e passe-a como cabeçalho: X-API-Key: <your key> (ou Authorization: Bearer <your key>). As chaves podem ter um orçamento total e/ou diário de créditos, então um loop descontrolado para no limite com um erro budget_exhausted em vez de drenar a conta.

Ferramentas

Todas as 9 ferramentas carregam anotações de ferramentas MCP (readOnly / destructive / idempotent / openWorld) e exigem a autenticação acima.

Ferramenta	O que faz
translate_icp	Converte uma descrição de ICP em texto livre (ex.: "encanadores em phoenix sem site") no dicionário estruturado query que o start_campaign exige. Chame esta primeiro: start_campaign nunca aceita texto livre.
start_campaign	Envia uma campanha de leads para um vertical + geo. Custa 1 crédito por lead validado e não pode gastar além. Aceita um idempotency_key para novas tentativas seguras. Retorna {job_id, idempotent_replay}.
get_campaign_status	Verifica o status de uma campanha pelo job_id: queued, running, done, done_partial ou failed.
fetch_results	Navega pelas páginas dos leads de uma campanha (offset/limit). kept_only=true retorna apenas leads marcados como mantidos na revisão. As linhas carregam recibos de verificação quando existe uma verificação ao vivo.
get_icp_pack	Lista os modelos de vertical/geo salvos (pacotes de ICP) disponíveis para a conta.
add_suppression	Adiciona um e-mail ou domínio à lista de supressão para que campanhas futuras o excluam.
review_lead	Marca um lead como kept, discarded ou unreviewed.
get_credits	Verifica o saldo de créditos pré-pagos (1 crédito = 1 lead validado), pacotes disponíveis e entradas recentes do livro-razão; com uma chave de API, também o orçamento restante dessa chave.
send_feedback	Envia feedback para a equipe do Nose for Leads (kind: "product" ou kind: "tool").

Recibos de verificação

As linhas retornadas por fetch_results carregam um recibo quando existe uma verificação ao vivo: verified_by (qual verificador), verified_at (quando) e verifier_verdict (o resultado). Um recibo prova que o e-mail foi verificado no provedor de caixa postal ao vivo, não apenas por correspondência de padrão. Veja examples/ para formatos reais de transcrições.

Créditos e semântica de segurança

• 1 crédito = 1 lead validado; 25 grátis no cadastro, pacotes pré-pagos a partir de US$ 19,99 por 200.
• Uma campanha que descubra mais leads do que o saldo cobre entrega o que os créditos cobrem e termina como done_partial em vez de falhar.
• Os orçamentos por chave são aplicados antes do saldo da conta, e o start_campaign honra o idempotency_key, então uma nova tentativa nunca cobra em dobro.
• Erros retornam um envelope simples {code, message} (ex.: payment_required, budget_exhausted, quota_exceeded com retry_after). A tabela completa está no guia do agente.