Plugin de ChatGPT y MCP
Datos de empresas directamente en ChatGPT, Claude y otros agentes de IA.
Con el plugin de ChatGPT y el servidor MCP, tu agente de IA consulta por sí mismo datos oficiales de empresas. Haces una pregunta en el chat, el agente elige las herramientas adecuadas y responde con datos del registro.
Plugin de ChatGPT
El plugin de ChatGPT es el camino más rápido. No necesitas clave API, porque al conectar inicias sesión con tu cuenta de handelsregister.ai.
- Abre el plugin de ChatGPT y añádelo en ChatGPT.
- Inicia sesión con tu cuenta de handelsregister.ai y confirma el acceso.
- Haz tu pregunta, por ejemplo “¿Quién dirige Hetzner Online GmbH y cómo ha evolucionado su facturación?”
Claude, Cursor y otros clientes MCP
MCP, el Model Context Protocol, es un estándar abierto con el que los agentes de IA acceden a herramientas y fuentes de datos. Cualquier cliente que se conecte a un servidor MCP por URL puede usar nuestro servidor.
| Qué | Valor |
|---|---|
| URL del servidor |
https://mcp.handelsregister.ai/mcp |
| Transporte | Streamable HTTP |
| Inicio de sesión | OAuth con tu cuenta, clave API en el header x-api-key o bearer token en el header Authorization |
Claude
En Claude añades el servidor MCP como conector personalizado. En los ajustes de conectores, elige “Add custom connector”, introduce un nombre y la URL del servidor e inicia sesión con tu cuenta de handelsregister.ai. Después activa el conector en el chat en “+” › “Connectors”.
En los espacios de trabajo Team y Enterprise, un propietario añade el conector para todos. Cada miembro conecta después su propia cuenta de handelsregister.ai.
Claude Code
En Claude Code añades el servidor con un comando. Con el header, Claude Code usa tu clave API.
claude mcp add --transport http handelsregister https://mcp.handelsregister.ai/mcp \ --header "x-api-key: TU_CLAVE_API"
Sin el header, inicias sesión en el navegador: abre una sesión y selecciona el servidor en /mcp.
Cursor
Cursor lee los servidores MCP de .cursor/mcp.json en el proyecto o de ~/.cursor/mcp.json para todos los proyectos. Muchos otros clientes usan el mismo formato.
{ "mcpServers": { "handelsregister": { "url": "https://mcp.handelsregister.ai/mcp", "headers": { "x-api-key": "TU_CLAVE_API" } } } }
Otros clientes MCP
Introduce la URL del servidor y envía tu clave API en el header x-api-key con cada solicitud. Como alternativa, usa un bearer token en el header Authorization; Autenticación muestra cómo crearlo.
Herramientas disponibles
El servidor MCP ofrece herramientas para tu cuenta, perfiles de empresa, personas, documentos, búsqueda y Signals. Todas las herramientas solo leen: no crean nada ni cambian ajustes. Cuestan tantos créditos como la misma solicitud a la API.
Las herramientas de empresa aceptan en el parámetro q una entity_id, un nombre de empresa o tribunal registral con número de registro, por ejemplo “Ansbach HRB 6089”. La entity_id de una búsqueda es lo más fiable. En la mayoría de las herramientas de empresa, ai_search activa el modo IA y realtime activa Tiempo real.
Cuenta
| Herramienta | Qué devuelve | Créditos |
|---|---|---|
| get_account_status | Plan, saldo, próxima caducidad de créditos y los datos que desbloquea tu plan. | gratis |
Perfil de empresa
Cada herramienta de empresa cuesta el precio base del perfil de empresa más el precio de su función, igual que fetch-organization. La función solo se cobra cuando devuelve datos.
| Herramienta | Qué devuelve | Créditos |
|---|---|---|
| get_company_overview | Los datos básicos: nombre, estado, forma jurídica, registro, dirección, capital, objeto social y sector. | 5 |
| get_company_snapshot | Datos básicos, KPI financieros y la administración actual en una sola llamada. | 5 + 1 + 2 |
| get_financials | KPI financieros por ejercicio, como facturación, resultado del ejercicio y empleados. | 5 + 1 |
| get_balance_sheet | El balance con todas sus partidas. | 5 + 3 |
| get_profit_and_loss | La cuenta de pérdidas y ganancias. | 5 + 3 |
| get_annual_financial_statements | Cuentas anuales en texto completo como Markdown. | 5 + 5 |
| get_annual_financial_statements_html | Cuentas anuales en texto completo como HTML. | 5 + 5 |
| get_related_persons | La administración y otras personas inscritas, también las anteriores si las pides. | 5 + 2 |
| get_shareholders | Los socios con sus participaciones. | 5 + 5 |
| get_ubos | Los titulares reales (UBO). | 5 + 10 |
| get_shareholdings | Las participaciones de la empresa en otras empresas. | 5 + 5 |
| get_mergers_and_acquisitions | Fusiones y adquisiciones (M&A) y contratos entre empresas. | 5 + 20 |
| get_publications | El historial de anuncios registrales. | 5 + 1 |
| get_insolvency_publications | Publicaciones de insolvencia. | 5 + 5 |
| get_news | Noticias de la web sobre la empresa. | 5 + 10 |
| get_website_content | El contenido de la web de la empresa como Markdown. Esta herramienta usa siempre el modo IA. | 5 + 20 (modo IA) |
| get_company_features | Varias funciones en una sola llamada, con un solo precio base. | 5 + funciones |
Personas y documentos
| Herramienta | Qué devuelve | Créditos |
|---|---|---|
| fetch_person | El perfil de persona: cargos, participaciones y trayectoria de una persona, buscada por nombre y una empresa relacionada. · desde Plus | 15, con participaciones + 5 |
| fetch_document | Un documento del registro: Aktueller Abdruck (AD, extracto actual), Chronologischer Abdruck (CD, extracto cronológico), Strukturierter Registerinhalt (SI, contenido estructurado del registro), Gesellschafterliste (lista de socios) o estatutos. | 15 |
Búsqueda
Las herramientas de búsqueda devuelven hasta 30 resultados por página, cada uno con su entity_id. Tu agente la usa después para obtener el perfil de empresa.
| Herramienta | Qué devuelve | Créditos |
|---|---|---|
| search_organizations | Encontrar empresas por nombre o filtros. | 1 por página |
| search_organizations_advanced | Búsqueda con todos los filtros de la API y ordenación, por ejemplo por facturación o fecha de fundación. | 1 por página |
| find_companies_by_industry | Empresas de un sector, descrito con palabras o como código WZ. | 1 por página |
| find_companies_by_financials | Empresas por facturación, empleados, resultado del ejercicio, patrimonio neto y otros KPI. | 1 por página |
| find_companies_near | Empresas alrededor de un lugar, las más cercanas primero. | 1 por página |
| find_newly_registered_companies | Empresas recién inscritas en un periodo. | 1 por página |
| find_recently_changed_companies | Empresas con cambios recientes, por ejemplo en la administración, el domicilio social o el capital. | 1 por página |
| find_related_companies | Empresas conectadas mediante participaciones, cargos, fusiones o contratos entre empresas. | 1 por página |
| find_companies_by_person | Empresas en las que una persona ocupa un cargo. La búsqueda por socio está disponible con Pro y Max. | 1 por página |
| find_companies_by_ownership | Empresas por estructura de propiedad, por ejemplo dirigidas por sus propietarios o familiares. · Pro, Max | 1 por página |
| find_companies_by_management | Empresas por edad y tamaño de la administración. · Pro, Max | 1 por página |
| find_companies_in_insolvency | Empresas en procedimiento de insolvencia, por fase y periodo. · Pro, Max | 1 por página |
| get_search_filter_reference | Los valores permitidos de los filtros de búsqueda. | gratis |
| find_industry_codes | Códigos WZ para un sector descrito con palabras, por ejemplo “desarrollo de software”. | gratis |
Signals
Las herramientas de Signals devuelven cambios en el registro de todas las empresas, hasta 20 por página. Una página se cobra aunque esté vacía.
| Herramienta | Qué devuelve | Créditos |
|---|---|---|
| get_recent_new_registrations | Nuevas inscripciones. | 20 por página |
| get_recent_management_changes | Cambios en la administración. | 20 por página |
| get_recent_capital_changes | Cambios de capital. | 20 por página |
| get_recent_master_data_changes | Cambios de datos básicos como nombre, domicilio social o dirección. | 20 por página |
| get_recent_company_closures | Cierres y disoluciones. | 20 por página |
| get_recent_insolvency_events | Insolvencias. · Pro, Max | 20 por página |
| get_recent_mergers_and_transformations | Transformaciones y M&A. · Max | 20 por página |
| get_recent_company_changes | Todos los cambios de hasta cinco empresas concretas. | 20 por página |
| get_signal_details | Una sola señal con todos los detalles. | 20 |
Costes
Cada llamada a una herramienta cuesta tantos créditos como la misma solicitud a la API. No hay una tarifa aparte por MCP. Los créditos se descuentan de la cuenta con la que iniciaste sesión o a la que pertenece la clave API.
Rigen las mismas reglas que en la API: las funciones sin datos no cuestan nada, y una llamada fallida no cuesta nada. El modo IA se cobra incluso sin coincidencia, Tiempo real por cada consulta en directo correcta. Cada resultado indica los créditos cobrados en meta.request_credit_cost y tu saldo en meta.credits_remaining.
Los límites también son los mismos que en la API, para documentos por ejemplo 5 solicitudes por minuto. Más en Facturación y Límites.