Servidor MCP

prometiam-risk-mcp

Datos de empresas para Claude, Cursor, VS Code y cualquier cliente MCP: registros mercantiles de 35 países, eventos societarios, notificaciones de insolvencia, cribado de sanciones (beta), comprobación de IVA y LEI y monitorización, en 36 herramientas tipadas. Un comando, sin clave y sin registro. Alemania procede de registros LEI y del registro del mercado de la energía, no del Handelsregister.

• Versión 0.4.54
• Herramientas 36
• Países 35
• Transporte stdio
• Licencia MIT
• Requiere Node 18 o posterior

Instálalo, sin clave

Elige tu cliente, pega el bloque y reinícialo. Sin clave, el servidor usa una clave de demostración compartida, así que la primera llamada responde enseguida. Funcionan la búsqueda de empresas, las fichas, el IVA, el LEI y la insolvencia; los eventos societarios y el cribado de sanciones requieren un plan, y la clave de demostración tiene límite de uso para todos los que la comparten.

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

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

claude mcp add prometiam-risk -- npx -y prometiam-risk-mcp

claude mcp add prometiam-risk -e PROMETIAM_API_KEY=rk_live_... -- npx -y prometiam-risk-mcp

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

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

{
  "servers": {
    "prometiam-risk": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "prometiam-risk-mcp"]
    }
  }
}

{
  "servers": {
    "prometiam-risk": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "prometiam-risk-mcp"],
      "env": { "PROMETIAM_API_KEY": "rk_live_..." }
    }
  }
}

npx -y prometiam-risk-mcp

PROMETIAM_API_KEY=rk_live_... npx -y prometiam-risk-mcp

Endpoint alojado (sin instalación)

Las mismas 36 herramientas se sirven por Streamable HTTP en https://api.prometiam.com/functions/v1/mcp: sin npx y sin proceso local. Envía tu propia clave como Authorization: Bearer rk_live_... (X-API-Key también funciona). Sin clave funciona en modo demo con la clave de demostración compartida (30 solicitudes por minuto y 2.000 llamadas al día para todos, la misma cuota que la demo con npx); en modo demo algunas herramientas, como sanctions_screen y events_search, responden upgrade_required. El endpoint no guarda datos ni secretos: cada llamada a una herramienta es una solicitud a la API y cuesta los mismos créditos que la llamada REST (el cribado de sanciones está en beta). Tu propia clave solo funciona desde un cliente que pueda enviar una cabecera en la solicitud.

claude mcp add --transport http prometiam https://api.prometiam.com/functions/v1/mcp --header "Authorization: Bearer rk_live_..."

{
  "mcpServers": {
    "prometiam": {
      "url": "https://api.prometiam.com/functions/v1/mcp",
      "headers": { "Authorization": "Bearer ${env:PROMETIAM_API_KEY}" }
    }
  }
}

{
  "servers": {
    "prometiam": {
      "type": "http",
      "url": "https://api.prometiam.com/functions/v1/mcp",
      "headers": { "Authorization": "Bearer ${input:prometiam-key}" }
    }
  },
  "inputs": [
    { "type": "promptString", "id": "prometiam-key", "description": "Prometiam API key", "password": true }
  ]
}

{
  "mcpServers": {
    "prometiam": {
      "serverUrl": "https://api.prometiam.com/functions/v1/mcp",
      "headers": { "Authorization": "Bearer ${env:PROMETIAM_API_KEY}" }
    }
  }
}

Conectores de claude.ai y ChatGPT: todavía no. Necesitan inicio de sesión con OAuth, que el endpoint alojado aún no ofrece.

Comprueba que funciona

Pregunta a tu asistente:

Busca empresas llamadas Inditex en España.

Llama a companies_search y devuelve:

INDUSTRIA DE DISEÑO TEXTIL, S.A, NIF A15075062, activa, forma jurídica SA, Arteixo, LEI 549300TTCXZOGZM2EY83.

Un 401 en la primera llamada indica una versión antigua de prometiam-risk-mcp que enviaba el marcador como si fuera una clave real. Actualízala o quita el bloque env.

Última comprobación en Claude Desktop, Claude Code, Cursor y VS Code: Por confirmar

Pregúntale

Preguntas que funcionan, la herramienta que llama cada una y lo que devolvió. Las respuestas grabadas se tomaron con la clave de demostración el 24 oct 2026, desde el endpoint que envuelve la herramienta; el servidor MCP devuelve el mismo JSON.

• “¿Es válido el IVA ESA15075062 y de qué empresa es?”

  Llama a vat_validate, company_by_identifier

  VIES confirma que el número es válido. La coincidencia en el registro es INDUSTRIA DE DISEÑO TEXTIL, S.A (BORME), la misma empresa de arriba.

  Respuesta grabada

• “Busca el LEI 549300TTCXZOGZM2EY83.”

  Llama a lei_lookup

  INDUSTRIA DE DISEÑO TEXTIL, S.A., jurisdicción ES, estado de la entidad ACTIVE, domiciliada en la Avenida de la Diputación, Arteixo.

  Respuesta grabada

• “¿Qué ha pasado en esta empresa el último año?”

  Llama a events_timeline

  La clave de demostración responde 403 upgrade_required: los eventos societarios no están en el plan gratuito, el plan Starter (9,99 EUR/mes) los incluye.

  Rechazada con la clave de demostración

• “Criba el nombre Juan Perez contra las listas de sanciones con umbral 85.”

  Llama a sanctions_screen

  La clave de demostración responde 403 upgrade_required: el cribado de sanciones (beta) no está en el plan gratuito, el plan Professional (29,99 EUR/mes) lo incluye. Una puntuación es una señal para revisar, no una determinación.

  Rechazada con la clave de demostración

• “Comprueba si estas cinco contrapartes tienen notificaciones de insolvencia corporativa en Francia y Alemania.”

  Llama a insolvency_check

  Una llamada, 2 créditos por nombre y un estado por nombre. Solo notificaciones corporativas, dieciséis mercados.

  No grabada aquí

Herramientas, créditos y plan

Una llamada correcta cuesta créditos y un error no cuesta nada. Plan es el plan más bajo que ejecuta la herramienta; Gratis es la clave de demostración y la prueba de 14 días. Las herramientas por lotes cobran cada elemento.

Cuando una llamada falla

Servidor MCP o API REST

La referencia REST está en documentación de la API.

Límites de alcance

• El cribado de sanciones es beta. El cribado PEP (una opción de sanctions_screen) es beta, solo de España y sin familiares ni allegados.
• Las notificaciones de insolvencia son solo corporativas, de dieciséis mercados: FR, DE, GB, AT, CH, NO, FI, US, NL, DK, HR, SE, ES, LV y EE. Contains CVR data (Erhvervsstyrelsen), CC BY 4.0.
• La monitorización cubre todos los países vivos salvo Francia y Chile: cambio de estado, disolución, coincidencia de sanciones y eventos societarios. Solo monitor_subscribe, monitor_stop, sanctions_watch y sanctions_unwatch modifican algo en tu cuenta; las demás herramientas son de solo lectura.
• Hay administradores de España, Francia, Reino Unido y Noruega; los de Polonia van en la ficha de la empresa, con las personas físicas enmascaradas por el propio registro. Los demás países son solo fichas de empresa: sin administradores ni señal de cumplimiento registral. Los empresarios individuales y demás personas físicas no se sirven en la mayoría de registros.
• Los eventos societarios son notificaciones de gaceta de España, Francia y Reino Unido (Suiza también desde el Boletín Oficial de Comercio suizo) y eventos de cambio registral en los demás países vivos, fechados cuando el cambio aparece por primera vez en los datos del registro. Irlanda, Polonia y Noruega: solo eventos de cambio registral, ninguno antes del 14 oct 2026.
• Alemania son entidades con LEI y empresas del registro del mercado de la energía, no un extracto del Handelsregister. Estados Unidos son solo fichas de empresa: ocho registros estatales más declarantes de la SEC y titulares de LEI, no todas las empresas de EE. UU.
• Las cuentas anuales (company_financials) son cuentas depositadas en GB, FR, DK, SE, NO, LV, FI (presentadas en formato digital), EE, RO y LT (cifras principales), CO y US (declarantes de la SEC), y empresas cotizadas en ES, PL, HR, BE y BR; plan Scale o superior, 10 llamadas al mes en los planes inferiores.

Preguntas frecuentes

¿Funciona el servidor sin clave de API?
Sí. Incluye una clave de demostración compartida, así que la primera llamada responde justo después de npx. La clave tiene límite de uso para todos los que la comparten; cuando se agota la cuota compartida, el error indica cómo obtener una clave gratuita.

¿Qué añade mi propia clave?
Una clave propia no se comparte con nadie y desbloquea los permisos de pago: personas y eventos societarios desde Starter (9,99 EUR/mes), cribado de sanciones desde Professional (29,99 EUR/mes), cuentas anuales desde Scale (99,99 EUR/mes). La prueba gratuita de 14 días da 500 créditos, requiere tarjeta y no se cobra nada durante 14 días.

¿Con qué clientes funciona?
Con cualquier cliente que hable MCP por stdio. Claude Desktop, Claude Code, Cursor y VS Code están configurados arriba; Continue y Cline funcionan igual.

¿Puede el agente cambiar algo en mi cuenta?
Solo mediante monitor_subscribe, monitor_stop, sanctions_watch y sanctions_unwatch, marcadas como que modifican tu cuenta; el resto de herramientas son de solo lectura. Guarda la clave en la configuración del cliente, nunca en un prompt.

¿Cuenta una llamada contra mi cuota?
Sí. Una llamada correcta cuesta créditos: 1 por una búsqueda o ficha de empresa, 2 por personas, eventos o insolvencia, 3 por cada nombre cribado, 25 por las cuentas anuales de una empresa; los errores no cuestan nada. Las herramientas por lotes cobran cada elemento.

¿Son los mismos datos que la API REST?
Sí. Cada herramienta llama al mismo endpoint que describe la documentación de la API y la especificación OpenAPI.

¿Por qué mi cliente muestra un 401?
Un prometiam-risk-mcp anterior a la 0.4.45 lee el marcador rk_live_your_key_here como si fuera una clave real. Actualízalo, o quita el bloque env para usar la clave de demostración.

Relacionado

• Por qué un agente de IA necesita datos oficiales de empresas
• Integraciones: n8n, Postman y los SDK de TypeScript y Python
• Documentación de la API: en inglés
• Precios

Esta página describe prometiam-risk-mcp 0.4.54. El mismo texto en Markdown: /mcp.md