Regístrate

Caso de uso · Agentes de IA y MCP

Datos de empresas para agentes de IA

Un asistente al que se le pregunta «¿esta empresa es real, está activa y no aparece en sanciones?» y responde con su memoria de entrenamiento está adivinando. Prometiam publica un servidor Model Context Protocol para que Claude Desktop, Cursor y cualquier cliente MCP respondan desde los registros oficiales que cubre la API — con el registro que respalda cada respuesta.

Nombres de herramientas tal como se publican en prometiam-risk-mcp a 15 de septiembre de 2026

El problema

Un modelo de lenguaje sabe mucho sobre empresas y nada de ello está actualizado. No puede decir si un proveedor español se disolvió el mes pasado, quién se incorporó al consejo de una empresa británica la semana pasada, o si un nombre se añadió ayer a una lista de sanciones, y cuando no lo sabe produce algo plausible. Un analista de cumplimiento no puede documentar «lo dijo el modelo», y un agente automatizado que actúa sobre una conjetura es un riesgo.

La solución no es un modelo más grande. Es una herramienta que el modelo llama y que devuelve el registro oficial, tipado, con fecha e identificador, de modo que la respuesta se pueda comprobar y citar. Para eso está el servidor MCP.

Conéctalo en una línea

El servidor se ejecuta en local dentro de tu cliente MCP y no necesita clave: sin ella usa una clave de demostración compartida, así que la primera llamada responde al instante. Para tus propios créditos, añade PROMETIAM_API_KEY a la configuración (la prueba gratuita, 500 créditos durante 14 días, con tarjeta, sin cobro hasta que termine la prueba, basta para probarlo). Claude Desktop lee claude_desktop_config.json; Cursor lee .cursor/mcp.json; la forma es la misma:

{
  "mcpServers": {
    "prometiam-risk": {
      "command": "npx",
      "args": ["-y", "prometiam-risk-mcp"]
    }
  }
}

Reinicia el cliente y las herramientas aparecen en su lista. La configuración completa para Continue, Cline y un cliente stdio directo está en el README del paquete.

Qué puede hacer el agente con esto

Las herramientas envuelven los mismos endpoints que la API REST, así que todo lo que está en la documentación es accesible en lenguaje natural:

  • Resolver una empresa — companies_search por nombre o identificador registral (NIF, SIREN/SIRET, número de Companies House, CRO, KRS, número de organización, Y-tunnus, organisationsnummer, número de empresa, MBS/OIB, número CVR, código de registro estonio, IČO eslovaco); company_detail para la ficha completa (estado, domicilio registrado, capital, código de actividad, administradores donde el registro los tenga, include=risk_flags para la señal de deuda tributaria publicada de España); companies_lookup para hasta 100 a la vez.
  • Seguir a las personas — people_search, person_detail (cada nombramiento, con fechas y si está vigente) y directors_network (personas en muchos consejos). Los administradores se conservan para España, Francia, Reino Unido y Noruega; Irlanda es a nivel de empresa y los administradores de Polonia y los administradores y socios de Chequia solo están en la ficha de empresa (personas físicas polacas enmascaradas por el propio registro; las checas, solo el nombre y el mes y año de nacimiento; sin búsqueda de personas ni red).
  • Leer el historial — events_search y events_timeline: cambios de capital, cambios de administradores, disoluciones, fusiones, insolvencia, para España, Francia y Reino Unido.
  • Comprobar dificultades — insolvency_check (hasta 100 contrapartes en FR, DE, GB, AT, CH, NO, FI, US, NL, DK, HR, SE, ES, LV, EE y SG, solo corporativo), insolvency_notices_search, e insolvency_search para los anuncios concursales de España.
  • Cribar nombres — sanctions_screen y sanctions_screen_batch contra las listas de la UE, ONU, OFAC, Reino Unido, Australia (DFAT) y francesa más la US Consolidated Screening List, con puntuación de coincidencia (match_score) y un umbral (beta); sanctions_changes para lo que se añadió o retiró de una lista desde una fecha.
  • Validar y enlazar — vat_validate (VIES), lei_lookup, lei_search, lei_relationships (matrices y filiales según GLEIF).
  • Seguir vigilando — monitor_subscribe pone una empresa en monitorización diaria con webhooks firmados (todos los países en producción excepto Francia y Chile, con México limitado a las entidades con LEI y Argentina sin alerta de disolución); monitor_list, monitor_get, monitor_stop.

Preguntas que ya puede responder

Cada una de estas es una tarea de varios pasos que el propio modelo planifica — buscar, luego ver la ficha, luego cribar — y cada paso devuelve un registro que puede citar:

  • “¿ACME SL es una empresa activa en España y quiénes son sus administradores actuales?”
  • “¿Alguna empresa de esta lista de veinte proveedores tiene una notificación de insolvencia corporativa en Francia o Alemania?”
  • “Criba estos cinco nombres de contrapartes contra sanciones con umbral 85 y muéstrame las coincidencias con su lista de origen.”
  • “¿En qué otras empresas es administrador esta persona en el Reino Unido, y alguna está disuelta?”
  • “Valida este número de IVA y dame el nombre y el domicilio registrados.”
  • “¿Qué eventos societarios presentó esta empresa francesa en los últimos doce meses?”

Construir tu propio agente en lugar de usar MCP

Si tu agente no habla MCP, dale la API REST como herramienta. La especificación OpenAPI 3.0 en /openapi.json es el esquema de herramientas; /llms.txt y /pricing.md están escritos para que los lea un modelo. Una herramienta de verificación son pocas líneas:

import os, requests

BASE = "https://api.prometiam.com/functions/v1/risk-api"
H = {"Authorization": "Bearer " + os.environ["PROMETIAM_API_KEY"]}

def verify_company(name: str, country: str, threshold: int = 85) -> dict:
    """Tool for an agent: official record + sanctions check, nothing decided."""
    hits = requests.get(BASE + "/companies/search",
                        params={"country": country, "name": name, "limit": 3},
                        headers=H, timeout=20).json()["data"]
    if not hits:
        return {"found": False, "name": name, "country": country}
    best = hits[0]                                  # highest match_score first
    detail = requests.get(BASE + "/companies/" + str(best["id"]),
                          params={"country": country}, headers=H, timeout=20).json()["data"]
    screen = requests.get(BASE + "/sanctions/screen",
                          params={"name": detail["company_name"], "threshold": threshold,
                                  "entity_type": "entity"},
                          headers=H, timeout=20).json()
    return {
        "found": True,
        "match_score": best["match_score"],
        "company_number": detail["company_number"],
        "company_name": detail["company_name"],
        "status": detail["status"],
        "founding_date": detail.get("founding_date"),
        "sanctions_hits": screen.get("data", []),   # a hit is for review, not a verdict
        "source": "official registry via Prometiam, " + detail.get("last_seen_date", ""),
    }

Registra verify_company como herramienta en tu modelo y describe su salida con honestidad: un registro de la fuente oficial y una lista de coincidencias de cribado con sus puntuaciones. El modelo decide qué preguntar; la herramienta nunca decide qué concluir.

Barreras de seguridad que importan

  • Solo lectura por defecto. Solo monitor_subscribe y monitor_stop modifican algo, y el paquete las marca como mutantes. Pide al cliente que confirme esas dos.
  • Hechos, no veredictos. La API devuelve registros y una puntuación de coincidencia (match_score). Haz que el agente presente una coincidencia de sanciones con su puntuación, lista de origen y alias para que una persona la revise, y que nunca escriba por su cuenta «esta empresa está sancionada».
  • La clave se queda fuera del prompt. Vive en la configuración del cliente o en el entorno. Usa una clave con solo los alcances que el agente necesita; el uso se ve por clave en el panel.
  • Cada llamada cuenta. Una petición por cada llamada a una herramienta, y una llamada correcta consume créditos; las herramientas por lotes cuentan cada elemento. Un agente que repite llamadas sin control gasta créditos rápido, así que configura las descripciones de las herramientas para preferir los lotes con listas.
  • Registra las respuestas. Guarda lo que devolvió la herramienta, con su fecha, junto a la respuesta del agente. Ese es el rastro de auditoría que un revisor va a pedir.

Encaje de precios

Un analista que hace treinta preguntas al día, con tres o cuatro llamadas cada una, usa unas 2.500 llamadas al mes, casi todas a 1 crédito (eventos, insolvencia y nombres cribados cuestan 2 o 3): unos pocos miles de créditos, dentro de Professional (29,99 €/mes, 10.000 créditos), que además incluye el alcance completo de cribado de sanciones y control de exportaciones. Un equipo de cinco personas, o un agente que criba listas largas, encaja en Scale (99,99 €/mes, 50.000 créditos). Probarlo no cuesta nada: la prueba de Starter es de 500 créditos durante 14 días sin cobro hasta que termine la prueba.

Límites de alcance, dichos con claridad

  • Irlanda es a nivel de empresa y los administradores de Polonia y los administradores y socios de Chequia solo están en la ficha de empresa (personas físicas polacas enmascaradas por el propio registro; las checas, solo el nombre y el mes y año de nacimiento; sin búsqueda de personas ni red). Irlanda, Polonia y Noruega solo tienen eventos de cambio del registro, desde el 14 de octubre de 2026 (sin boletín).
  • Las notificaciones de insolvencia son solo corporativas, en dieciséis mercados (FR, DE, GB, AT, CH, NO, FI, US, NL, DK, HR, SE, ES, LV, EE, SG); los concursos de acreedores de España están entre ellos, y insolvency_search sigue sirviendo sus anuncios concursales.
  • La monitorización cubre todos los países en producción excepto Francia y Chile, con México limitado a las entidades con LEI y Argentina sin alerta de disolución. El cribado de sanciones es beta; el cribado PEP es beta, solo España, sin familiares ni allegados cercanos (RCA).
  • Sin puntuaciones de crédito y sin titularidad real fuera del registro PSC británico (GLEIF Level-2 da las matrices de las empresas que tienen LEI). Estados financieros: GB, FR, DK, SE, NO y emisores que presentan ante la SEC en Estados Unidos desde el plan Scale, FI (estados presentados en formato digital, aproximadamente uno de cada veinte declarantes) y solo las empresas cotizadas de ES, PL, HR y BE (informes ESEF; no se dispone de todos, los de Polonia llegan con más de un año de retraso y los informes de las empresas cotizadas españolas están disponibles gratuitamente en el sitio web de la CNMV).

Preguntas frecuentes

¿Qué es un servidor MCP para datos de empresas?
Un servidor Model Context Protocol es un programa pequeño que un cliente de IA (Claude Desktop, Cursor, Continue, Cline y otros) arranca en local; expone herramientas tipadas que el modelo puede llamar. prometiam-risk-mcp expone la API de Prometiam como herramientas — búsqueda y ficha de empresa, administradores, eventos societarios, comprobación de insolvencia, cribado de sanciones, validación de IVA y LEI, monitorización — para que el modelo responda desde datos oficiales de registro en lugar de su memoria de entrenamiento, y pueda mostrar el registro que usó.

¿Con qué clientes de IA funciona?
Con cualquier cliente que hable MCP sobre stdio: Claude Desktop, Cursor, Continue y Cline están documentados en el README del paquete. Un agente construido sobre otra pila llama directamente a la API REST y puede cargar la especificación OpenAPI 3.0 en /openapi.json como esquema de herramientas.

¿Puede el agente modificar algo en mi cuenta?
Solo mediante dos herramientas, monitor_subscribe y monitor_stop, marcadas como mutantes; el resto es solo lectura. Guarda la clave en la configuración del cliente, no en un prompt, y usa una clave con solo los alcances que el agente necesita.

¿Una llamada a una herramienta consume mi cuota?
Sí. Una llamada correcta a una herramienta consume créditos (1 por una búsqueda o ficha de empresa, 2 por eventos, personas o insolvencia, 3 por cada nombre cribado; los errores no cuestan nada), y las herramientas por lotes (companies_lookup, sanctions_screen_batch, insolvency_check) cobran cada elemento por separado. La prueba gratuita de 14 días incluye 500 créditos sin cobro hasta que termine la prueba; Starter cuesta 9,99 € al mes por 1.000 créditos. Professional cuesta 29,99 € por 10.000 créditos.

¿La respuesta es una decisión?
No. La API devuelve hechos de registro y, para el cribado, una puntuación de coincidencia (match_score) frente a las listas que gestiona. Una coincidencia de sanciones es un aviso para revisar, no un veredicto, y el agente debe decirlo así. El cribado de sanciones es beta; el cribado PEP es beta y solo España.

Relacionado