Leadscart

npx add-mcp 'https://leadscart.io/api/mcp'

Contactos y correos verificados para agentes

Busca contactos B2B por cargo, empresa, industria, tamaño de plantilla, país y tecnología, y luego revela correos laborales verificados, a través de un servidor MCP y una API REST. Mismos créditos y reglas de supresión que la aplicación, en todos los planes, incluido el gratuito.

MCP: https://leadscart.io/api/mcpREST: https://leadscart.io/api/v1 openapi.json

Lo que está disponible

Cada herramienta y endpoint a continuación lleva una insignia. Live significa que puedes llamarlo hoy. Planned significa que el contrato está publicado pero las llamadas devuelven 404 con details.status: "not_implemented". El documento OpenAPI marca lo mismo con x-status y siempre es la fuente de verdad.

Claves API y autenticación LiveEnvoltura de créditos LiveLímites de velocidad por clave LiveServidor MCP LiveOpenAPI Live

Inicio rápido

Elige tu herramienta y sigue los pasos; toma alrededor de un minuto. Claude te permite iniciar sesión, por lo que no necesita clave. Cualquier otra herramienta necesita una clave API desde Configuración → API y MCP. Las claves comienzan con lc_live_ y se muestran una sola vez.

No se necesita clave API. En su lugar, inicia sesión en Leadscart.

1. Abre la página de conectores de Claude y haz clic en Agregar conector personalizado.
2. Completa los dos campos: Nombre Leadscart URL https://leadscart.io/api/mcp
3. Haz clic en Agregar y luego en Conectar. Inicia sesión en Leadscart y haz clic en Permitir.
4. Inicia un nuevo chat y pide personas. Por ejemplo: "Encuentra 10 VP de Ventas en fintechs de EE. UU. con 50–200 empleados" La búsqueda es gratuitaCopiar

Funciona también en las aplicaciones de escritorio y móvil de Claude. En un plan Team o Enterprise, un propietario de Claude lo agrega una vez en Configuración de la organización → Conectores.

Para desconectar más tarde, revoca "Claude (conectado)" en las claves API en Configuración → API y MCP.

Recetas de flujo de trabajo

En n8n y Clay, cada llamada es una solicitud HTTP con el mismo encabezado Authorization. Dos comunes:

Node: HTTP Request
Method: POST
URL: https://leadscart.io/api/v1/people/search
Authentication: Generic → Header Auth
  Name:  Authorization
  Value: Bearer lc_live_…
Body (JSON): {"filters": {"titles": ["VP Sales"], "countries": ["US"]}}

Autenticación

• Envía Authorization: Bearer lc_live_… en cada solicitud a /api/v1/* y /api/mcp.
• Las claves pertenecen a un espacio de trabajo y gastan sus créditos. Almacenamos solo un hash; una clave perdida no se puede recuperar, solo reemplazar.
• Las claves caducan después de 180 días y se pueden revocar en cualquier momento desde Configuración.
• Nunca pongas una clave en código de navegador. Úsala desde servidores, agentes y herramientas de flujo de trabajo.

curl https://leadscart.io/api/v1/credits \
  -H "Authorization: Bearer lc_live_…"

Límites de velocidad

Cada clave puede enviar 120 solicitudes por minuto (ventana deslizante). Si superas el límite, obtienes 429 rate_limited con un encabezado Retry-After. Las búsquedas también cuentan contra un presupuesto diario de páginas por espacio de trabajo, que se muestra como 429 o 503 budget_exhausted.

Créditos en cada respuesta

Las respuestas JSON exitosas se envuelven en una sola envoltura, para que un agente siempre sepa cuánto costó una llamada. Las exportaciones CSV llevan los mismos números en los encabezados X-Credits-Spent y X-Credits-Remaining. Los errores también incluyen credits (gastado es 0).

{
  "data": { … },
  "credits": { "spent": 3, "remaining": 197 }
}

Costos: buscar y exportar es gratuito; 1 por persona revelada (solo cuando se devuelve un correo verificado o un número de teléfono; el teléfono está incluido). Cada llamada muestra su costo máximo antes de gastar nada.

Herramientas MCP

Los nombres de las herramientas son noun_verb. Las entradas y salidas a continuación son bosquejos; los esquemas de herramientas del servidor MCP son exactos. Para guías de conexión de clientes, manuales y avisos, consulta nuestra descripción general dedicada del Servidor MCP de Datos B2B.

people_search Live

Busca contactos por cargo, empresa, industria, tamaño de plantilla, país y tecnología.

entrada

{ filtros: { títulos, países, rangos_de_empleados, … }, página? 1–50 }

salida

ok { personas, total } · demasiado_amplio / sin_coincidencias { sugerencias }

créditos

Gratis para buscar y exportar · 1 por correo o teléfono verificado

email_find Live

Encuentra correos laborales verificados, y números de teléfono cuando los tengamos, para clientes potenciales ya en una Lista.

entrada

{ lead_ids: string[] ≤ 25, idempotency_key? }

salida

{ resultados: { lead_id, correo, teléfono, estado }[] }

créditos

1 por correo o teléfono verificado · fallos gratis

list_create Live

Crea una Lista para recopilar clientes potenciales.

entrada

{ nombre }

salida

{ id, nombre }

créditos

Gratis

list_add Live

Agrega personas (por URL de LinkedIn) a una Lista. Las personas suprimidas se omiten.

entrada

{ list_id, personas: { linkedin_url, … }[] ≤ 500 }

salida

{ agregadas, ya_en_lista, suprimidas, lead_ids }

créditos

Gratis

list_export Live

Exporta una Lista como filas JSON o CSV.

entrada

{ list_id, include_emails? } (REST:?format=json|csv)

salida

{ filas } o CSV

créditos

Gratis para exportar

credits_balance Live

Saldo actual y créditos que caducan pronto.

entrada

{}

salida

{ saldo, listas_equivalentes, caducan_en_7_días, próxima_caducidad }

créditos

Gratis

Endpoints REST

URL base https://leadscart.io/api/v1. JSON de entrada, JSON de salida. Los esquemas completos de solicitud y respuesta están en /api/v1/openapi.json. ChatGPT rechaza descripciones de acciones de más de 300 caracteres, así que importa /api/v1/openapi.json?for=chatgpt allí: la misma API, descrita más brevemente.

GET/api/v1/credits Saldo de créditos· credits_balanceLive

POST/api/v1/people/search Buscar personas· people_searchLive

POST/api/v1/emails/find Encontrar correos laborales verificados· email_findLive

GET/api/v1/lists Listar ListasLive

POST/api/v1/lists Crear una Lista· list_createLive

POST/api/v1/lists/{id}/items Agregar personas a una Lista· list_addLive

GET/api/v1/lists/{id}/export Exportar una Lista· list_exportLive

Errores

Los errores comparten una misma forma. message es seguro de mostrar a un usuario; retryable le dice a un agente si debe reintentar.

{
  "error": {
    "code": "insufficient_credits",
    "message": "You don't have enough credits for this. Buy credits to continue.",
    "retryable": false
  },
  "credits": { "spent": 0, "remaining": 12 }
}

401 unauthorized Clave API faltante, malformada, caducada o revocada. Verifica el encabezado Authorization; crea una nueva clave.

402 insufficient_credits El saldo no puede cubrir el costo máximo de esta llamada. Elige un plan más grande o reduce credit_budget.

409 conflict Ya hay una operación conflictiva en curso, por ejemplo, la misma ejecución o exportación. Espera a que termine y luego reintenta.

422 provider_rejected La entrada es JSON válido pero no se puede ejecutar: valores de filtro desconocidos o una consulta imposible. Corrige los filtros mencionados en details.

429 rate_limited Más de 120 solicitudes por minuto en esta clave. Espera los segundos de Retry-After.

503 provider_unavailable · budget_exhausted Un proveedor de datos está caído o la capacidad de hoy está agotada. Reintenta más tarde; retryable es true.

No en v1

Para que puedas planificar en consecuencia, esto no está disponible ni prometido:

• alertas y webhooks;
• sincronización de CRM y asientos de equipo;
• planes ilimitados o enriquecimiento en cascada entre proveedores.

¿Preguntas o un caso de uso que no cubrimos? Consulta precios o inicia sesión y crea una clave.