apiempresas-mcp 0.0.0-stage → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +89 -3
  3. package/dist/index.js +261 -0
  4. package/package.json +48 -6
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 APIEmpresas
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,89 @@
1
- # Temporary Holding Version
2
-
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
1
+ # APIEmpresas MCP
2
+
3
+ Servidor [MCP](https://modelcontextprotocol.io) oficial de [APIEmpresas.es](https://apiempresas.es): datos de empresas españolas para Claude, Cursor, VS Code y cualquier asistente compatible con MCP.
4
+
5
+ Pregunta en lenguaje natural ("¿Mercadona está activa y quiénes son sus administradores?", "saca el CIF de estas 40 empresas", "¿esta empresa ha tenido un concurso?") y el asistente consulta la API con tu clave.
6
+
7
+ ## Herramientas
8
+
9
+ | Herramienta | Qué hace | Plan |
10
+ |---|---|---|
11
+ | `get_company` | Empresa por CIF: razón social, estado, constitución, provincia, CNAE, forma jurídica (ISO 20275) y LEI; domicilio, socio único, matriz del grupo y administradores según plan | Free (datos recortados), Pro |
12
+ | `search_companies` | Buscar empresas por nombre | Free |
13
+ | `verify_company` | Verificación KYB: existe, activa, nombre y administrador (o socio único) coinciden y, si se pide, NIF-IVA en VIES; con forma jurídica, LEI, matriz y socio único (2 consultas) | Pro |
14
+ | `find_cif_by_name` | De nombre a CIF, hasta 100 a la vez, con provincia opcional para desempatar (solo cobra las coincidencias) | Pro |
15
+ | `get_borme_history` | Actos publicados en el BORME | Pro |
16
+ | `get_risk_profile` | Perfil de riesgo a partir del BORME | Business |
17
+ | `get_public_contracts` | Contratos públicos adjudicados | Business |
18
+ | `search_tenders` | Licitaciones públicas abiertas: por palabras, CPV, provincia, tipo e importe, o parecidas a lo que ya ha ganado una empresa (`cif`) | Business |
19
+ | `check_sanctions` | Listas de sanciones de la UE, la ONU y OFAC: una empresa y sus administradores (`cif`) o un nombre (`name`), con el grado de cada coincidencia | Business |
20
+ | `get_usage` | Plan, consultas disponibles y saldo de créditos (gratis; no funciona en el Sandbox) | Todos |
21
+
22
+ Todas son de solo lectura. Cada llamada gasta consultas de tu plan, igual que la API.
23
+
24
+ ## Instalación
25
+
26
+ 1. Crea una cuenta gratis (100 consultas, sin tarjeta) en [apiempresas.es](https://apiempresas.es/register?intent=api&plan=free&source=mcp) y copia tu API key del panel.
27
+ 2. Añade el servidor a tu cliente (necesita Node.js 18 o superior).
28
+
29
+ ### Claude Desktop
30
+
31
+ En `claude_desktop_config.json`:
32
+
33
+ ```json
34
+ {
35
+ "mcpServers": {
36
+ "apiempresas": {
37
+ "command": "npx",
38
+ "args": ["-y", "apiempresas-mcp"],
39
+ "env": { "APIEMPRESAS_API_KEY": "tu_api_key" }
40
+ }
41
+ }
42
+ }
43
+ ```
44
+
45
+ ### Claude Code
46
+
47
+ ```bash
48
+ claude mcp add apiempresas --env APIEMPRESAS_API_KEY=tu_api_key -- npx -y apiempresas-mcp
49
+ ```
50
+
51
+ ### Cursor
52
+
53
+ En `~/.cursor/mcp.json` (o `.cursor/mcp.json` en el proyecto), el mismo bloque `mcpServers` que en Claude Desktop.
54
+
55
+ ### VS Code
56
+
57
+ En `.vscode/mcp.json`:
58
+
59
+ ```json
60
+ {
61
+ "servers": {
62
+ "apiempresas": {
63
+ "type": "stdio",
64
+ "command": "npx",
65
+ "args": ["-y", "apiempresas-mcp"],
66
+ "env": { "APIEMPRESAS_API_KEY": "tu_api_key" }
67
+ }
68
+ }
69
+ }
70
+ ```
71
+
72
+ ### Pruebas sin coste
73
+
74
+ Con `APIEMPRESAS_BASE_URL=https://apiempresas.es/api/sandbox/v1` las llamadas no gastan consultas (solo admite los CIF de prueba A15075062 y B00000000).
75
+
76
+ ## Qué conviene saber
77
+
78
+ - El estado registral, el scoring y el perfil de riesgo los calcula APIEmpresas a partir del BORME: no son un certificado del Registro Mercantil.
79
+ - No cubre titular real, listas de sanciones o PEP, ni empresarios individuales (autónomos).
80
+ - Precios: Free 100 consultas; Pro 19 €/mes (3.000/mes); Business 49 €/mes (10.000/mes); bonos sin suscripción desde 9 €. IVA no incluido. Detalle en [apiempresas.es](https://apiempresas.es/#precios).
81
+ - Documentación completa de la API: [apiempresas.es/documentation](https://apiempresas.es/documentation).
82
+
83
+ ## English
84
+
85
+ Official MCP server for [APIEmpresas.es](https://apiempresas.es), a REST API for Spanish company data: lookup by CIF (tax ID), name search, KYB verification, directors, BORME (Commercial Registry gazette) filings, public contracts and risk profile. Get a free API key (100 requests) at apiempresas.es and run `npx -y apiempresas-mcp` with `APIEMPRESAS_API_KEY` set.
86
+
87
+ ## Licencia
88
+
89
+ MIT
package/dist/index.js ADDED
@@ -0,0 +1,261 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Servidor MCP de APIEmpresas.es
4
+ *
5
+ * Expone la API de datos de empresas españolas como herramientas de solo lectura para
6
+ * asistentes de IA (Claude, Cursor, VS Code...). Usa la API key del propio usuario:
7
+ * cada llamada gasta consultas de su plan, igual que si llamara a la API directamente.
8
+ *
9
+ * Variables de entorno:
10
+ * APIEMPRESAS_API_KEY (obligatoria) clave de https://apiempresas.es/dashboard
11
+ * APIEMPRESAS_BASE_URL (opcional) por defecto https://apiempresas.es/api/v1;
12
+ * https://apiempresas.es/api/sandbox/v1 para pruebas sin coste
13
+ */
14
+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
15
+ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
16
+ import { z } from 'zod';
17
+ export const VERSION = '1.2.0';
18
+ const API_KEY = (process.env.APIEMPRESAS_API_KEY || '').trim();
19
+ const BASE_URL = (process.env.APIEMPRESAS_BASE_URL || 'https://apiempresas.es/api/v1').replace(/\/+$/, '');
20
+ const TIMEOUT_MS = 30_000;
21
+ /** Las respuestas grandes (historial del BORME, contratos) se recortan para no llenar el contexto. */
22
+ const MAX_CHARS = 60_000;
23
+ const SIGNUP_URL = 'https://apiempresas.es/register?intent=api&plan=free&source=mcp';
24
+ function texto(t, isError = false) {
25
+ return isError ? { content: [{ type: 'text', text: t }], isError: true } : { content: [{ type: 'text', text: t }] };
26
+ }
27
+ function json(data) {
28
+ let t = JSON.stringify(data, null, 2);
29
+ if (t.length > MAX_CHARS) {
30
+ t = t.slice(0, MAX_CHARS) + '\n… (respuesta recortada: pide menos resultados o una página concreta)';
31
+ }
32
+ return texto(t);
33
+ }
34
+ /** CIF/NIF en el formato que espera la API: sin espacios, guiones ni puntos y en mayúsculas. */
35
+ function limpiarCif(cif) {
36
+ return cif.replace(/[\s.\-]/g, '').toUpperCase();
37
+ }
38
+ const cifSchema = z
39
+ .string()
40
+ .min(9)
41
+ .max(15)
42
+ .describe('CIF/NIF de la empresa española, p. ej. A46103834 (se aceptan espacios y guiones)');
43
+ /** Mensaje de error útil para el asistente y para la persona: qué pasó y qué hacer. */
44
+ function mensajeError(status, body) {
45
+ const partes = [];
46
+ const b = body && typeof body === 'object' ? body : {};
47
+ const primero = b.messages && typeof b.messages === 'object' ? Object.values(b.messages)[0] : '';
48
+ const msg = b.message || b.detail || (typeof b.error === 'string' ? b.error : '') || (typeof primero === 'string' ? primero : '');
49
+ const code = typeof b.code === 'string' ? b.code : '';
50
+ partes.push(`Error ${status}${code ? ` (${code})` : ''}: ${msg || 'la API no ha devuelto detalle'}`);
51
+ // Qué hacer, según el código estable de la API (13-10-2026)
52
+ const plan = typeof b.required_plan === 'string' ? ` (necesita el plan ${b.required_plan === 'business' ? 'Business' : 'Pro'})` : '';
53
+ const consejos = {
54
+ API_KEY_MISSING: `Falta la API key. Se obtiene gratis en ${SIGNUP_URL} y se configura en APIEMPRESAS_API_KEY.`,
55
+ API_KEY_INVALID: `La API key no es válida. Se obtiene gratis en ${SIGNUP_URL} y se configura en APIEMPRESAS_API_KEY.`,
56
+ API_KEY_INACTIVE: 'La API key o la cuenta están desactivadas. Revísalo en el panel de APIEmpresas.',
57
+ COUNTRY_NOT_ALLOWED: 'La API key no admite peticiones desde este país (se configura en el panel).',
58
+ TEST_MODE_RESTRICTION: 'En el Sandbox solo valen los CIF de prueba A15075062 (encontrada) y B00000000 (no encontrada).',
59
+ PLAN_RESTRICTION: `Este dato no está incluido en el plan actual de la cuenta${plan}.`,
60
+ UPGRADE_REQUIRED: `Este dato no está incluido en el plan actual de la cuenta${plan}.`,
61
+ QUOTA_EXCEEDED: 'Se han agotado las consultas del plan y no queda saldo. Reintentar no sirve.',
62
+ TOO_MANY_REQUESTS: 'Demasiadas peticiones por segundo: espera un momento y vuelve a intentarlo.',
63
+ IP_LIMIT_EXCEEDED: 'Se ha alcanzado el límite de seguridad por IP del plan Free.',
64
+ PREVIEW_LIMIT_EXCEEDED: 'Se ha alcanzado el límite diario de vistas previas gratuitas. Vuelve mañana o mejora el plan.',
65
+ COMPANY_NOT_FOUND: 'No hay ninguna empresa con ese CIF o nombre en la base de datos.',
66
+ AUTONOMO_NOT_SUPPORTED: 'Es un DNI o NIE: la API solo tiene datos de sociedades, no de autónomos.',
67
+ FAKE_CIF_NOT_ALLOWED: 'Es un CIF de prueba: en producción usa un CIF real (los de prueba solo valen en el Sandbox).',
68
+ INVALID_CIF_FORMAT: 'El CIF no tiene un formato válido.',
69
+ RISK_PROFILE_NOT_AVAILABLE: 'La empresa existe, pero no tiene perfil de riesgo calculado.',
70
+ };
71
+ if (code && consejos[code]) {
72
+ partes.push(consejos[code]);
73
+ }
74
+ else if (status === 401) {
75
+ partes.push(consejos.API_KEY_INVALID);
76
+ }
77
+ else if (status === 403) {
78
+ partes.push('Este dato no está incluido en el plan actual de la cuenta.');
79
+ }
80
+ // Enlaces de compra que trae la propia API en los 403/429 (arriba o dentro de upsell_opportunities)
81
+ const etiquetas = {
82
+ starter_url: 'Bono de 1.000 créditos (pago único)',
83
+ checkout_url: 'Mejorar plan',
84
+ recharge_url: 'Recargar créditos',
85
+ upgrade_url: 'Planes',
86
+ };
87
+ const up = b.upsell_opportunities && typeof b.upsell_opportunities === 'object' ? b.upsell_opportunities : {};
88
+ const vistos = new Set();
89
+ for (const [k, etiqueta] of Object.entries(etiquetas)) {
90
+ const url = (typeof b[k] === 'string' && b[k]) || (typeof up[k] === 'string' && up[k]) || '';
91
+ if (url && !vistos.has(url)) {
92
+ vistos.add(url);
93
+ partes.push(`${etiqueta}: ${url}`);
94
+ }
95
+ }
96
+ return partes.join('\n');
97
+ }
98
+ async function llamar(path, init = {}) {
99
+ if (!API_KEY) {
100
+ return texto(`Falta la API key de APIEmpresas. Crea una cuenta gratis (100 consultas, sin tarjeta) en ${SIGNUP_URL}, ` +
101
+ 'copia la clave del panel y ponla en la variable de entorno APIEMPRESAS_API_KEY de la configuración del servidor MCP.', true);
102
+ }
103
+ const controller = new AbortController();
104
+ const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
105
+ try {
106
+ const headers = {
107
+ 'X-API-KEY': API_KEY,
108
+ Accept: 'application/json',
109
+ 'User-Agent': `apiempresas-mcp/${VERSION}`,
110
+ };
111
+ if (init.body)
112
+ headers['Content-Type'] = 'application/json';
113
+ const res = await fetch(`${BASE_URL}${path}`, { ...init, headers, signal: controller.signal });
114
+ const tipo = res.headers.get('content-type') || '';
115
+ const body = tipo.includes('application/json') ? await res.json().catch(() => null) : await res.text();
116
+ if (!res.ok) {
117
+ return texto(mensajeError(res.status, body), true);
118
+ }
119
+ return json(body);
120
+ }
121
+ catch (e) {
122
+ if (e?.name === 'AbortError') {
123
+ return texto(`La API no respondió en ${TIMEOUT_MS / 1000} s. Prueba de nuevo en un momento.`, true);
124
+ }
125
+ return texto(`No se pudo conectar con la API (${BASE_URL}): ${e?.message || e}`, true);
126
+ }
127
+ finally {
128
+ clearTimeout(timer);
129
+ }
130
+ }
131
+ function qs(params) {
132
+ const p = new URLSearchParams();
133
+ for (const [k, v] of Object.entries(params)) {
134
+ if (v === undefined || v === '')
135
+ continue;
136
+ p.set(k, typeof v === 'boolean' ? (v ? 'true' : 'false') : String(v));
137
+ }
138
+ return p.toString();
139
+ }
140
+ const soloLectura = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true };
141
+ export function crearServidor() {
142
+ const server = new McpServer({ name: 'apiempresas', version: VERSION });
143
+ server.registerTool('get_company', {
144
+ title: 'Empresa por CIF',
145
+ description: "Ficha de UNA empresa española cuando ya tienes su CIF/NIF. Úsala para saber si existe y está activa, su razón social, forma jurídica (con código ISO 20275), código LEI, CNAE, provincia y fecha de constitución; con plan Pro, también domicilio, tramo de facturación, socio único, matriz del grupo y, con include_directors, los administradores vigentes. Si no tienes el CIF, usa search_companies; para decidir un alta (KYB), verify_company. Gasta 1 consulta. Spanish company lookup by tax ID.",
146
+ inputSchema: {
147
+ cif: cifSchema,
148
+ include_directors: z
149
+ .boolean()
150
+ .optional()
151
+ .describe('true para incluir administradores y cargos vigentes (planes Pro y Business)'),
152
+ },
153
+ annotations: soloLectura,
154
+ }, async ({ cif, include_directors }) => llamar(`/companies?${qs({ cif: limpiarCif(cif), admin: include_directors ? true : undefined })}`));
155
+ server.registerTool('search_companies', {
156
+ title: 'Buscar empresas por nombre',
157
+ description: "Busca empresas españolas por nombre o parte del nombre y devuelve las candidatas con su CIF, provincia y estado. Úsala cuando NO tienes el CIF de una empresa concreta; después, get_company con el CIF elegido. Para convertir una lista de muchos nombres en CIF, mejor find_cif_by_name. Search Spanish companies by name.",
158
+ inputSchema: {
159
+ query: z.string().min(2).describe('Nombre o parte del nombre de la empresa'),
160
+ limit: z.number().int().min(1).max(25).optional().describe('Número máximo de resultados (por defecto 10)'),
161
+ },
162
+ annotations: soloLectura,
163
+ }, async ({ query, limit }) => llamar(`/companies/search?${qs({ q: query, multiple: true, limit: limit ?? 10 })}`));
164
+ server.registerTool('verify_company', {
165
+ title: 'Verificación KYB',
166
+ description: "Verificación para dar de alta a un cliente o proveedor (KYB) en una llamada: comprueba que la sociedad existe y opera, que la razón social que te han dado coincide (name), que quien firma es administrador vigente o socio único (person) y, si se pide, el NIF-IVA en VIES (vat). Devuelve alertas y una recomendación pass / review / fail, además de forma jurídica, LEI, matriz y socio único. Úsala para decidir; para solo consultar datos, get_company. Plan Pro; gasta 2 consultas. KYB check for a Spanish company.",
167
+ inputSchema: {
168
+ cif: cifSchema,
169
+ name: z.string().optional().describe('Razón social que ha declarado el cliente, para comprobar que coincide'),
170
+ person: z.string().optional().describe('Nombre de la persona que firma, para comprobar si es administradora o socia única'),
171
+ vat: z.boolean().optional().describe('true para comprobar además el NIF-IVA en VIES (operador intracomunitario)'),
172
+ },
173
+ annotations: soloLectura,
174
+ }, async ({ cif, name, person, vat }) => llamar(`/companies/verify?${qs({ cif: limpiarCif(cif), name, person, vat: vat ? true : undefined })}`));
175
+ server.registerTool('find_cif_by_name', {
176
+ title: 'De nombre a CIF',
177
+ description: "Convierte una LISTA de nombres de empresa (hasta 100) en sus CIF, con resultado match, ambiguous o no_match para cada uno. Úsala para completar hojas de clientes o proveedores que solo tienen el nombre. Solo los match gastan consulta. Para un solo nombre, search_companies. Plan Pro.",
178
+ inputSchema: {
179
+ names: z.array(z.string().min(2)).min(1).max(100).describe('Nombres de empresas'),
180
+ province: z
181
+ .string()
182
+ .optional()
183
+ .describe('Provincia (p. ej. VALENCIA) para desempatar entre empresas con el mismo nombre; se aplica a todos'),
184
+ },
185
+ annotations: soloLectura,
186
+ }, async ({ names, province }) => llamar('/companies/reconcile', {
187
+ method: 'POST',
188
+ body: JSON.stringify({ items: names.map((name) => (province ? { name, province } : { name })) }),
189
+ }));
190
+ server.registerTool('get_borme_history', {
191
+ title: 'Historial del BORME',
192
+ description: "Todos los actos publicados en el BORME de una empresa, con fecha y PDF oficial: constitución, nombramientos y ceses, ampliaciones de capital, cambios de domicilio o de nombre, disolución, concurso... Úsala para la historia y los cambios recientes; para el estado actual basta get_company. Plan Pro.",
193
+ inputSchema: { cif: cifSchema },
194
+ annotations: soloLectura,
195
+ }, async ({ cif }) => llamar(`/companies/borme?${qs({ cif: limpiarCif(cif) })}`));
196
+ server.registerTool('get_risk_profile', {
197
+ title: 'Perfil de riesgo',
198
+ description: "Nivel de riesgo de una empresa y sus motivos, calculado a partir de sus publicaciones en el BORME (concursos, disoluciones, cierres de hoja registral, cuentas no depositadas, cambios de administradores...). Úsala antes de dar crédito o firmar con un proveedor. Plan Business.",
199
+ inputSchema: { cif: cifSchema },
200
+ annotations: soloLectura,
201
+ }, async ({ cif }) => llamar(`/companies/risk-profile?${qs({ cif: limpiarCif(cif) })}`));
202
+ server.registerTool('get_public_contracts', {
203
+ title: 'Contratos públicos',
204
+ description: "Contratos del sector público adjudicados a una empresa (Plataforma de Contratación del Sector Público): organismo, objeto, importe y fecha. Plan Business.",
205
+ inputSchema: {
206
+ cif: cifSchema,
207
+ page: z.number().int().min(1).optional().describe('Página (por defecto 1)'),
208
+ limit: z.number().int().min(1).max(50).optional().describe('Contratos por página (por defecto 20)'),
209
+ },
210
+ annotations: soloLectura,
211
+ }, async ({ cif, page, limit }) => llamar(`/companies/contracts?${qs({ cif: limpiarCif(cif), page: page ?? 1, limit: limit ?? 20 })}`));
212
+ server.registerTool('search_tenders', {
213
+ title: 'Licitaciones públicas abiertas',
214
+ description: "Licitaciones públicas EN PLAZO en España (Plataforma de Contratación del Sector Público y plataformas autonómicas): título, organismo, provincia, importe, plazo de ofertas, CPV y enlace para presentarse. Filtra por palabras del título (query), CPV, provincia, tipo (supplies, services, works) e importe. Con cif, devuelve las abiertas parecidas a los contratos que esa empresa ya ha ganado: úsala para \"¿a qué concursos se puede presentar esta empresa?\". Plan Business; gasta 1 consulta. Open public tenders in Spain.",
215
+ inputSchema: {
216
+ query: z.string().min(3).optional().describe('Palabras que deben aparecer en el título, p. ej. "limpieza colegios"'),
217
+ cpv: z.string().optional().describe('CPV o su principio, separados por comas (p. ej. "72,48" para informática)'),
218
+ province: z.string().optional().describe('Provincia del organismo, p. ej. Madrid, Barcelona, Bizkaia'),
219
+ type: z.enum(['supplies', 'services', 'works']).optional().describe('Tipo de contrato'),
220
+ min_amount: z.number().min(0).optional().describe('Importe mínimo sin IVA (euros)'),
221
+ max_amount: z.number().min(0).optional().describe('Importe máximo sin IVA (euros)'),
222
+ cif: z.string().optional().describe('CIF de una empresa: licitaciones parecidas a lo que ya ha ganado'),
223
+ limit: z.number().int().min(1).max(50).optional().describe('Número de licitaciones (por defecto 20)'),
224
+ },
225
+ annotations: soloLectura,
226
+ }, async ({ query, cpv, province, type, min_amount, max_amount, cif, limit }) => llamar(`/tenders?${qs({ q: query, cpv, province, type, min_amount, max_amount, cif: cif ? limpiarCif(cif) : undefined, limit: limit ?? 20 })}`));
227
+ server.registerTool('check_sanctions', {
228
+ title: 'Listas de sanciones',
229
+ description: "Comprueba si una empresa española (por cif, junto con sus administradores vigentes) o un nombre suelto (name) aparece en las listas de sanciones de la UE, la ONU y OFAC (EE. UU.). Devuelve cada coincidencia con su grado (strong o possible), la lista, el programa, la fecha, el país y la fecha de nacimiento para confirmarla o descartarla: un nombre parecido no es una coincidencia confirmada. Úsala en altas de clientes o proveedores (KYB, prevención de blanqueo). Plan Business; gasta 1 consulta. Sanctions screening (EU, UN, OFAC).",
230
+ inputSchema: {
231
+ cif: z.string().optional().describe('CIF de la empresa (se comprueban la razón social y los administradores)'),
232
+ name: z.string().min(3).optional().describe('Nombre de una persona o entidad, en lugar de cif'),
233
+ type: z.enum(['person', 'entity', 'any']).optional().describe('Con name: person, entity o any'),
234
+ },
235
+ annotations: soloLectura,
236
+ }, async ({ cif, name, type }) => {
237
+ if (!cif && !name) {
238
+ return texto('Indica el CIF de una empresa (cif) o un nombre de al menos 3 letras (name).', true);
239
+ }
240
+ return llamar(`/sanctions/screen?${qs(cif ? { cif: limpiarCif(cif) } : { name, type })}`);
241
+ });
242
+ server.registerTool('get_usage', {
243
+ title: 'Consumo de la cuenta',
244
+ description: "Plan de la cuenta del usuario, consultas usadas y disponibles y saldo de créditos. No gasta consultas. Úsala si una herramienta responde que se ha agotado el cupo.",
245
+ inputSchema: {},
246
+ annotations: soloLectura,
247
+ }, async () => llamar('/usage'));
248
+ return server;
249
+ }
250
+ async function main() {
251
+ const server = crearServidor();
252
+ await server.connect(new StdioServerTransport());
253
+ // stdout es el canal del protocolo: los avisos van a stderr
254
+ if (!API_KEY) {
255
+ console.error(`[apiempresas-mcp] Falta APIEMPRESAS_API_KEY. Clave gratis en ${SIGNUP_URL}`);
256
+ }
257
+ }
258
+ main().catch((e) => {
259
+ console.error('[apiempresas-mcp] Error al arrancar:', e);
260
+ process.exit(1);
261
+ });
package/package.json CHANGED
@@ -1,6 +1,48 @@
1
- {
2
- "name": "apiempresas-mcp",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
1
+ {
2
+ "name": "apiempresas-mcp",
3
+ "version": "1.2.0",
4
+ "description": "Servidor MCP oficial de APIEmpresas.es: datos de empresas españolas (CIF, BORME, administradores, KYB, listas de sanciones, licitaciones abiertas, riesgo) para Claude, Cursor y otros asistentes de IA",
5
+ "mcpName": "io.github.abasmartinc/apiempresas",
6
+ "type": "module",
7
+ "bin": {
8
+ "apiempresas-mcp": "dist/index.js"
9
+ },
10
+ "main": "dist/index.js",
11
+ "files": [
12
+ "dist",
13
+ "README.md",
14
+ "LICENSE"
15
+ ],
16
+ "engines": {
17
+ "node": ">=18"
18
+ },
19
+ "scripts": {
20
+ "build": "tsc",
21
+ "test": "npm run build && node tests/smoke.mjs",
22
+ "prepublishOnly": "npm run build"
23
+ },
24
+ "keywords": [
25
+ "mcp",
26
+ "model-context-protocol",
27
+ "apiempresas",
28
+ "empresas",
29
+ "cif",
30
+ "nif",
31
+ "borme",
32
+ "registro mercantil",
33
+ "kyb",
34
+ "spain",
35
+ "spanish companies"
36
+ ],
37
+ "homepage": "https://apiempresas.es",
38
+ "author": "APIEmpresas",
39
+ "license": "MIT",
40
+ "dependencies": {
41
+ "@modelcontextprotocol/sdk": "^1.32.1",
42
+ "zod": "^3.25.0"
43
+ },
44
+ "devDependencies": {
45
+ "@types/node": "^20.11.19",
46
+ "typescript": "^5.3.3"
47
+ }
48
+ }