# SignalDesk (https://signaldesk.lat) > Señales de compra y reuniones para empresas B2B en España y Latinoamérica, pago por uso, pensado para agentes de IA y para personas. Documentación completa para agentes. Fase 0: solo la lista de espera funciona; la API y el MCP están en acceso anticipado. # Precios ## Precios orientativos de acceso anticipado Señal de compra: 0,50 USD por señal entregada. Se cobra solo cuando la señal se entrega. Ficha de empresa: 2,00 USD por ficha. Datos de una empresa B2B en una sola consulta. Reunión conseguida: 35,00 USD por reunión conseguida. (próximamente) Todavía no está disponible. 5 USD de crédito de prueba por cuenta verificada. Pago con créditos prepagados (Mercado Pago). Sin suscripción: cada consulta descuenta saldo. Nota: orientativos, pueden cambiar antes del lanzamiento. Todavía no hay cobro: la API de pago no está abierta. # Agentes ## Estado: acceso anticipado La API REST y el servidor MCP de SignalDesk están en acceso anticipado. Todavía no están abiertas ni cobran: lo que ves abajo es el diseño previsto y puede cambiar. Para acceder cuando abran, apúntate a la lista de espera en la página principal o con POST /api/public/waitlist (único endpoint que funciona hoy). ## Autenticación y créditos Cada petición llevará una clave de API en la cabecera Authorization: Bearer . La clave pertenece a una cuenta verificada. Cada cuenta tiene un saldo en créditos prepagados (USD). Cada señal entregada o ficha consultada descuenta su precio del saldo. Si no hay saldo suficiente, la API responderá 402 Payment Required con un enlace de recarga (top_up_url) para que el agente o su responsable recargue y reintente. Respuesta 402 (ejemplo): ```json { "error": "payment_required", "message": "Saldo insuficiente.", "balance_usd": 0.2, "required_usd": 0.5, "top_up_url": "https://signaldesk.lat/recarga/ejemplo" } ``` ## search_signals Busca señales de compra de empresas B2B. Se cobra por señal entregada. Parámetros previstos: country (código ISO 3166-1 de 2 letras), sector (texto), signal_type (texto, opcional), limit (1 a 50, por defecto 10). Los valores de las respuestas son de ejemplo; no son datos reales. Petición: ```http POST https://signaldesk.lat/api/v1/signals/search Authorization: Bearer Content-Type: application/json { "country": "ES", "sector": "logística", "limit": 2 } ``` Respuesta 200 (ejemplo): ```json { "signals": [ { "id": "sig_ejemplo_1", "company_id": "cmp_ejemplo_1", "type": "ejemplo", "summary": "Texto de ejemplo.", "detected_at": "2026-01-01T00:00:00Z" } ], "charged_usd": 0.5, "balance_usd": 4.5 } ``` ## get_company Devuelve la ficha de una empresa a partir de su identificador. Se cobra por ficha. Petición: ```http GET https://signaldesk.lat/api/v1/companies/cmp_ejemplo_1 Authorization: Bearer ``` Respuesta 200 (ejemplo): ```json { "id": "cmp_ejemplo_1", "name": "Empresa Ejemplo", "country": "ES", "website": "https://ejemplo.example", "sector": "logística", "charged_usd": 2, "balance_usd": 2.5 } ``` ## get_balance Consulta el saldo de créditos de la cuenta. No tiene coste. Petición: ```http GET https://signaldesk.lat/api/v1/balance Authorization: Bearer ``` Respuesta 200 (ejemplo): ```json { "balance_usd": 4.5, "currency": "USD" } ``` ## top_up Crea un enlace de pago de Mercado Pago para recargar créditos. El saldo se acredita cuando el pago se confirma. Petición: ```http POST https://signaldesk.lat/api/v1/balance/top-up Authorization: Bearer Content-Type: application/json { "amount_usd": 20 } ``` Respuesta 201 (ejemplo): ```json { "top_up_url": "https://signaldesk.lat/recarga/ejemplo", "amount_usd": 20, "provider": "mercadopago" } ``` ## Servidor MCP El servidor MCP expondrá las mismas cuatro herramientas (search_signals, get_company, get_balance, top_up) con la misma clave y el mismo saldo. Está en acceso anticipado y aún no tiene URL pública.