FirstSales

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

Para desarrolladores y agentes

API de FirstSales y Recursos para Desarrolladores

Usa la API pública del sitio web para diagnósticos de entregabilidad de solo lectura. Para flujos de trabajo de cuentas autenticadas, usa la API de Desarrollador canónica, la CLI firstsales, o el MCP de producto protegido por OAuth documentado en developer.firstsales.io.

API de Desarrollador y CLI

La API de Desarrollador autenticada cubre flujos de trabajo de producto con ámbito de cuenta y es separada de la API de diagnósticos públicos de este sitio.

• Introducción a la plataforma de desarrolladores
• JSON OpenAPI de la API de Desarrollador canónica
• Referencia de la CLI de FirstSales — paquete npm @firstsales.io/cli, binario firstsales
• Guía del MCP de producto protegido por OAuth

Especificación OpenAPI

Toda la superficie REST está descrita por un documento OpenAPI 3.1 legible por máquina, por lo que cualquier generador de clientes, marco de agentes o explorador de API puede importarlo directamente.

• </openapi.json> — especificación OpenAPI 3.1, JSON
• </api/openapi.yaml> — la misma especificación, YAML

Servidor MCP

FirstSales ejecuta un servidor de Protocolo de Contexto de Modelo (MCP) sobre HTTP Streamable, por lo que cualquier cliente MCP — Claude Desktop, Claude Code, o tu propio agente — puede llamar a estas herramientas directamente sin hacer scraping del sitio.

• </mcp/> — el endpoint MCP HTTP Streamable
• </.well-known/mcp.json> — manifiesto de descubrimiento

Configuración del cliente

Añade esto a tu configuración de cliente MCP de Claude Desktop (o cualquier cliente compatible con HTTP Streamable):

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

Endpoints REST

Las mismas capacidades expuestas como herramientas MCP también están disponibles como endpoints REST simples bajo /api/v1:

• validate_email
  Valida el formato de un correo electrónico, los registros MX y la existencia del dominio.
• check_disposable_email
  Comprueba si un correo electrónico usa un dominio desechable/temporal.
• check_catchall_domain
  Detecta si el buzón de un dominio está configurado como catch-all.
• check_domain_dns
  Ejecuta una verificación de SPF, DKIM, DMARC, MX, lista negra u otra verificación de DNS/entregabilidad.
• check_dkim
  Busca y valida los registros DKIM de un dominio.
• get_domain_age
  Obtiene la fecha de registro y la antigüedad de un dominio mediante RDAP/WHOIS.
• get_dns_records
  Obtiene los registros A, AAAA, MX, NS, TXT, CNAME y SOA de un dominio.
• analyze_spam_score
  Puntúa el contenido del cuerpo de un correo electrónico por palabras y patrones que activan spam.
• analyze_subject_line
  Analiza una línea de asunto por riesgo de spam y mejores prácticas de tasa de apertura.
• analyze_cold_email
  Analiza el texto de divulgación en frío por personalización, longitud y claridad de la llamada a la acción.
• list_tutorials
  Lista todos los tutoriales públicos de FirstSales.
• get_tutorial
  Obtiene el contenido completo de un tutorial por slug.

Política de versionado y desaprobación

La API está versionada en la ruta de la URL. La versión actual es v1, por lo que cada endpoint es accesible en https://firstsales.io/api/v1/<operation>. Un cambio disruptivo se publica bajo un nuevo prefijo; v1 mantiene su contrato. La forma sin prefijo /api/<operation> es un alias de la versión actual y puede cambiar sin previo aviso, así que llama a la forma /api/v1/.

Política de desaprobación

Una versión es compatible durante al menos 180 días después de que se anuncie su reemplazo. Una vez que una versión está desaprobada, sus respuestas llevan Deprecation: true y un encabezado Sunset con la fecha de retiro (RFC 8594), además de un encabezado Link que apunta a las notas de migración. Los retiros se anuncian en esta página. Ninguna versión está actualmente desaprobada.

Límites de tasa

Cada endpoint tiene límite de tasa por IP en una ventana de 60 segundos. Los límites son 20/min para las verificaciones de correo electrónico, 10/min para las búsquedas de DNS y dominio, y 30/min para los analizadores de contenido; el límite exacto de cada operación está en la especificación OpenAPI bajo x-rateLimit.

Cada respuesta lleva los campos de encabezado RateLimit de IETF, por lo que un cliente puede limitarse a sí mismo sin esperar un rechazo:

• RateLimit-Limit — solicitudes permitidas en la ventana actual
• RateLimit-Remaining — solicitudes aún disponibles
• RateLimit-Reset — segundos hasta que la ventana se reinicie
• RateLimit-Policy — la política, como <limit>;w=60

Sobre el límite, el endpoint responde 429 con un encabezado Retry-After en segundos y un cuerpo JSON que lleva error, message y hint.

Markdown para agentes

Cada página en firstsales.io tiene un espejo Markdown limpio para LLMs y rastreadores que prefieren texto estructurado sobre HTML.

• </llms.txt> — mapa de contenido completo
• /raw/*.md — espejo Markdown de cualquier página, p. ej. /raw/why.md

Documentación del producto

Para la API de Desarrollador, la CLI y los flujos de trabajo de agentes, consulta developer.firstsales.io.

Soporte

¿Preguntas sobre la API o el servidor MCP? Envía un correo a firstsales@support.communicate.so.