FirstSales

npx add-mcp 'https://firstsales.io/mcp/'

Para desenvolvedores e agentes

API FirstSales e Recursos para Desenvolvedores

Use a API pública do site para diagnósticos de entregabilidade somente leitura. Para fluxos de trabalho autenticados de conta, use a API de Desenvolvedor canônica, a CLI firstsales, ou o MCP de produto protegido por OAuth documentado em developer.firstsales.io.

API de Desenvolvedor e CLI

A API de Desenvolvedor autenticada cobre fluxos de trabalho de produto com escopo de conta e é separada da API pública de diagnósticos deste site.

• Introdução à plataforma de desenvolvedores
• JSON OpenAPI da API de Desenvolvedor canônica
• Referência da CLI FirstSales — pacote npm @firstsales.io/cli, binário firstsales
• Guia do MCP de produto protegido por OAuth

Especificação OpenAPI

Toda a superfície REST é descrita por um documento OpenAPI 3.1 legível por máquina, para que qualquer gerador de cliente, framework de agente ou explorador de API possa importá-lo diretamente.

• </openapi.json> — especificação OpenAPI 3.1, JSON
• </api/openapi.yaml> — a mesma especificação, YAML

Servidor MCP

A FirstSales executa um servidor Model Context Protocol (MCP) sobre Streamable HTTP, para que qualquer cliente MCP — Claude Desktop, Claude Code ou seu próprio agente — possa chamar essas ferramentas diretamente sem fazer scraping do site.

• </mcp/> — o endpoint MCP Streamable HTTP
• </.well-known/mcp.json> — manifesto de descoberta

Configuração do cliente

Adicione isto à configuração do seu cliente MCP Claude Desktop (ou qualquer cliente compatível com Streamable HTTP):

{
  "mcpServers": {
    "firstsales": {
      "url": "https://firstsales.io/mcp/"
    }
  }
}

Endpoints REST

As mesmas capacidades expostas como ferramentas MCP também estão disponíveis como endpoints REST simples sob /api/v1:

• validate_email
  Valida o formato de um e-mail, registros MX e existência do domínio.
• check_disposable_email
  Verifica se um e-mail usa um domínio descartável/temporário.
• check_catchall_domain
  Detecta se a caixa de correio de um domínio está configurada como catch-all.
• check_domain_dns
  Executa uma verificação de SPF, DKIM, DMARC, MX, blacklist ou outra verificação de DNS/entregabilidade.
• check_dkim
  Consulta e valida o(s) registro(s) DKIM de um domínio.
• get_domain_age
  Obtém a data de registro e a idade de um domínio via RDAP/WHOIS.
• get_dns_records
  Busca os registros A, AAAA, MX, NS, TXT, CNAME e SOA de um domínio.
• analyze_spam_score
  Pontua o conteúdo do corpo de um e-mail para palavras e padrões que acionam spam.
• analyze_subject_line
  Analisa uma linha de assunto quanto ao risco de spam e melhores práticas de taxa de abertura.
• analyze_cold_email
  Analisa o texto de prospecção a frio quanto a personalização, extensão e clareza do CTA.
• list_tutorials
  Lista todos os tutoriais públicos da FirstSales.
• get_tutorial
  Obtém o conteúdo completo de um tutorial pelo slug.

Política de versionamento e descontinuação

A API é versionada no caminho da URL. A versão atual é v1, então todo endpoint é acessível em https://firstsales.io/api/v1/<operation>. Uma mudança que quebra compatibilidade é lançada sob um novo prefixo; a v1 mantém seu contrato. A forma sem prefixo /api/<operation> é um alias para a versão atual e pode mudar sem aviso, então use a forma /api/v1/.

Política de descontinuação

Uma versão é suportada por pelo menos 180 dias após o anúncio de sua substituição. Quando uma versão é descontinuada, suas respostas carregam Deprecation: true e um cabeçalho Sunset com a data de aposentadoria (RFC 8594), além de um cabeçalho Link apontando para as notas de migração. As aposentadorias são anunciadas nesta página. Nenhuma versão está atualmente descontinuada.

Limites de taxa

Todo endpoint tem limite de taxa por IP em uma janela de 60 segundos. Os limites são 20/min para as verificações de e-mail, 10/min para consultas de DNS e domínio e 30/min para os analisadores de conteúdo; o limite exato de cada operação está na especificação OpenAPI sob x-rateLimit.

Toda resposta carrega os campos de cabeçalho RateLimit da IETF, para que um cliente possa se autorregular sem esperar uma recusa:

• RateLimit-Limit — solicitações permitidas na janela atual
• RateLimit-Remaining — solicitações ainda disponíveis
• RateLimit-Reset — segundos até a janela ser redefinida
• RateLimit-Policy — a política, como <limit>;w=60

Acima do limite, o endpoint responde 429 com um cabeçalho Retry-After em segundos e um corpo JSON carregando error, message e hint.

Markdown para agentes

Toda página em firstsales.io tem um espelho Markdown limpo para LLMs e rastreadores que preferem texto estruturado a HTML.

• </llms.txt> — mapa completo de conteúdo
• /raw/*.md — espelho Markdown de qualquer página, ex.: /raw/why.md

Documentação do produto

Para a API de Desenvolvedor, CLI e fluxos de trabalho de agente, veja developer.firstsales.io.

Suporte

Dúvidas sobre a API ou o servidor MCP? Envie um e-mail para firstsales@support.communicate.so.