apiempresas-mcp 1.1.0 → 1.3.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.
- package/README.md +3 -0
- package/dist/index.js +50 -20
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -15,6 +15,9 @@ Pregunta en lenguaje natural ("¿Mercadona está activa y quiénes son sus admin
|
|
|
15
15
|
| `get_borme_history` | Actos publicados en el BORME | Pro |
|
|
16
16
|
| `get_risk_profile` | Perfil de riesgo a partir del BORME | Business |
|
|
17
17
|
| `get_public_contracts` | Contratos públicos adjudicados | Business |
|
|
18
|
+
| `get_subsidies` | Subvenciones y ayudas públicas de la BDNS desde 2022 (Kit Digital incluido): resumen por año, instrumento y convocatoria, y las concesiones (desde 1.3.0) | Business |
|
|
19
|
+
| `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 |
|
|
20
|
+
| `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 |
|
|
18
21
|
| `get_usage` | Plan, consultas disponibles y saldo de créditos (gratis; no funciona en el Sandbox) | Todos |
|
|
19
22
|
|
|
20
23
|
Todas son de solo lectura. Cada llamada gasta consultas de tu plan, igual que la API.
|
package/dist/index.js
CHANGED
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
15
15
|
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
|
|
16
16
|
import { z } from 'zod';
|
|
17
|
-
export const VERSION = '1.
|
|
17
|
+
export const VERSION = '1.3.0';
|
|
18
18
|
const API_KEY = (process.env.APIEMPRESAS_API_KEY || '').trim();
|
|
19
19
|
const BASE_URL = (process.env.APIEMPRESAS_BASE_URL || 'https://apiempresas.es/api/v1').replace(/\/+$/, '');
|
|
20
20
|
const TIMEOUT_MS = 30_000;
|
|
@@ -142,11 +142,7 @@ export function crearServidor() {
|
|
|
142
142
|
const server = new McpServer({ name: 'apiempresas', version: VERSION });
|
|
143
143
|
server.registerTool('get_company', {
|
|
144
144
|
title: 'Empresa por CIF',
|
|
145
|
-
description:
|
|
146
|
-
'fecha de constitución, provincia, municipio, CNAE, forma jurídica (con código ISO 20275) y código LEI y, según el ' +
|
|
147
|
-
'plan, domicilio completo, tramo de facturación, socio único (ownership), matriz del grupo según GLEIF (group) y ' +
|
|
148
|
-
'administradores (include_directors). Gasta 1 consulta. El estado lo calcula APIEmpresas a partir del BORME; ' +
|
|
149
|
-
'no es un certificado del Registro Mercantil. Spanish company lookup by tax ID.',
|
|
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.",
|
|
150
146
|
inputSchema: {
|
|
151
147
|
cif: cifSchema,
|
|
152
148
|
include_directors: z
|
|
@@ -158,8 +154,7 @@ export function crearServidor() {
|
|
|
158
154
|
}, async ({ cif, include_directors }) => llamar(`/companies?${qs({ cif: limpiarCif(cif), admin: include_directors ? true : undefined })}`));
|
|
159
155
|
server.registerTool('search_companies', {
|
|
160
156
|
title: 'Buscar empresas por nombre',
|
|
161
|
-
description:
|
|
162
|
-
'Útil cuando no se conoce el CIF. Search Spanish companies by name.',
|
|
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.",
|
|
163
158
|
inputSchema: {
|
|
164
159
|
query: z.string().min(2).describe('Nombre o parte del nombre de la empresa'),
|
|
165
160
|
limit: z.number().int().min(1).max(25).optional().describe('Número máximo de resultados (por defecto 10)'),
|
|
@@ -168,10 +163,7 @@ export function crearServidor() {
|
|
|
168
163
|
}, async ({ query, limit }) => llamar(`/companies/search?${qs({ q: query, multiple: true, limit: limit ?? 10 })}`));
|
|
169
164
|
server.registerTool('verify_company', {
|
|
170
165
|
title: 'Verificación KYB',
|
|
171
|
-
description:
|
|
172
|
-
'y si una persona es administradora o el socio único, con alertas y una recomendación (pass / review / fail). ' +
|
|
173
|
-
'Devuelve también la forma jurídica, el LEI, la matriz del grupo y el socio único. ' +
|
|
174
|
-
'Plan Pro o superior; gasta 2 consultas. KYB check for a Spanish company.',
|
|
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.",
|
|
175
167
|
inputSchema: {
|
|
176
168
|
cif: cifSchema,
|
|
177
169
|
name: z.string().optional().describe('Razón social que ha declarado el cliente, para comprobar que coincide'),
|
|
@@ -182,8 +174,7 @@ export function crearServidor() {
|
|
|
182
174
|
}, async ({ cif, name, person, vat }) => llamar(`/companies/verify?${qs({ cif: limpiarCif(cif), name, person, vat: vat ? true : undefined })}`));
|
|
183
175
|
server.registerTool('find_cif_by_name', {
|
|
184
176
|
title: 'De nombre a CIF',
|
|
185
|
-
description:
|
|
186
|
-
'ambiguous o no_match; solo los match gastan consulta. Plan Pro o superior. Útil para completar hojas de clientes.',
|
|
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.",
|
|
187
178
|
inputSchema: {
|
|
188
179
|
names: z.array(z.string().min(2)).min(1).max(100).describe('Nombres de empresas'),
|
|
189
180
|
province: z
|
|
@@ -198,21 +189,19 @@ export function crearServidor() {
|
|
|
198
189
|
}));
|
|
199
190
|
server.registerTool('get_borme_history', {
|
|
200
191
|
title: 'Historial del BORME',
|
|
201
|
-
description:
|
|
202
|
-
'nombramientos y ceses, ampliaciones de capital, cambios de domicilio, disolución, concurso… Plan Pro o superior.',
|
|
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.",
|
|
203
193
|
inputSchema: { cif: cifSchema },
|
|
204
194
|
annotations: soloLectura,
|
|
205
195
|
}, async ({ cif }) => llamar(`/companies/borme?${qs({ cif: limpiarCif(cif) })}`));
|
|
206
196
|
server.registerTool('get_risk_profile', {
|
|
207
197
|
title: 'Perfil de riesgo',
|
|
208
|
-
description:
|
|
209
|
-
'cierres de hoja, cambios de administradores…), con nivel y explicación. Plan Business.',
|
|
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.",
|
|
210
199
|
inputSchema: { cif: cifSchema },
|
|
211
200
|
annotations: soloLectura,
|
|
212
201
|
}, async ({ cif }) => llamar(`/companies/risk-profile?${qs({ cif: limpiarCif(cif) })}`));
|
|
213
202
|
server.registerTool('get_public_contracts', {
|
|
214
203
|
title: 'Contratos públicos',
|
|
215
|
-
description:
|
|
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.",
|
|
216
205
|
inputSchema: {
|
|
217
206
|
cif: cifSchema,
|
|
218
207
|
page: z.number().int().min(1).optional().describe('Página (por defecto 1)'),
|
|
@@ -220,9 +209,50 @@ export function crearServidor() {
|
|
|
220
209
|
},
|
|
221
210
|
annotations: soloLectura,
|
|
222
211
|
}, async ({ cif, page, limit }) => llamar(`/companies/contracts?${qs({ cif: limpiarCif(cif), page: page ?? 1, limit: limit ?? 20 })}`));
|
|
212
|
+
// 1.3.0 (20-10-2026): igual que en el servidor remoto (app/Libraries/McpServer.php)
|
|
213
|
+
server.registerTool('get_subsidies', {
|
|
214
|
+
title: 'Subvenciones y ayudas públicas',
|
|
215
|
+
description: "Subvenciones, préstamos, garantías y ventajas fiscales concedidos a una empresa española según la Base de Datos Nacional de Subvenciones (BDNS), desde 2022, Kit Digital incluido: resumen por año, por instrumento y las convocatorias con más importe, y la lista de concesiones. Úsala para prospección de ayudas o para saber cuánto dinero público recibe. Plan Business; gasta 1 consulta. Public grants received by a Spanish company.",
|
|
216
|
+
inputSchema: {
|
|
217
|
+
cif: cifSchema,
|
|
218
|
+
year: z.number().int().min(2000).optional().describe('Solo las concesiones de ese año'),
|
|
219
|
+
limit: z.number().int().min(1).max(50).optional().describe('Concesiones por página (por defecto 20)'),
|
|
220
|
+
},
|
|
221
|
+
annotations: soloLectura,
|
|
222
|
+
}, async ({ cif, year, limit }) => llamar(`/companies/subsidies?${qs({ cif: limpiarCif(cif), year, limit: limit ?? 20 })}`));
|
|
223
|
+
server.registerTool('search_tenders', {
|
|
224
|
+
title: 'Licitaciones públicas abiertas',
|
|
225
|
+
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.",
|
|
226
|
+
inputSchema: {
|
|
227
|
+
query: z.string().min(3).optional().describe('Palabras que deben aparecer en el título, p. ej. "limpieza colegios"'),
|
|
228
|
+
cpv: z.string().optional().describe('CPV o su principio, separados por comas (p. ej. "72,48" para informática)'),
|
|
229
|
+
province: z.string().optional().describe('Provincia del organismo, p. ej. Madrid, Barcelona, Bizkaia'),
|
|
230
|
+
type: z.enum(['supplies', 'services', 'works']).optional().describe('Tipo de contrato'),
|
|
231
|
+
min_amount: z.number().min(0).optional().describe('Importe mínimo sin IVA (euros)'),
|
|
232
|
+
max_amount: z.number().min(0).optional().describe('Importe máximo sin IVA (euros)'),
|
|
233
|
+
cif: z.string().optional().describe('CIF de una empresa: licitaciones parecidas a lo que ya ha ganado'),
|
|
234
|
+
limit: z.number().int().min(1).max(50).optional().describe('Número de licitaciones (por defecto 20)'),
|
|
235
|
+
},
|
|
236
|
+
annotations: soloLectura,
|
|
237
|
+
}, 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 })}`));
|
|
238
|
+
server.registerTool('check_sanctions', {
|
|
239
|
+
title: 'Listas de sanciones',
|
|
240
|
+
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).",
|
|
241
|
+
inputSchema: {
|
|
242
|
+
cif: z.string().optional().describe('CIF de la empresa (se comprueban la razón social y los administradores)'),
|
|
243
|
+
name: z.string().min(3).optional().describe('Nombre de una persona o entidad, en lugar de cif'),
|
|
244
|
+
type: z.enum(['person', 'entity', 'any']).optional().describe('Con name: person, entity o any'),
|
|
245
|
+
},
|
|
246
|
+
annotations: soloLectura,
|
|
247
|
+
}, async ({ cif, name, type }) => {
|
|
248
|
+
if (!cif && !name) {
|
|
249
|
+
return texto('Indica el CIF de una empresa (cif) o un nombre de al menos 3 letras (name).', true);
|
|
250
|
+
}
|
|
251
|
+
return llamar(`/sanctions/screen?${qs(cif ? { cif: limpiarCif(cif) } : { name, type })}`);
|
|
252
|
+
});
|
|
223
253
|
server.registerTool('get_usage', {
|
|
224
254
|
title: 'Consumo de la cuenta',
|
|
225
|
-
description:
|
|
255
|
+
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.",
|
|
226
256
|
inputSchema: {},
|
|
227
257
|
annotations: soloLectura,
|
|
228
258
|
}, async () => llamar('/usage'));
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "apiempresas-mcp",
|
|
3
|
-
"version": "1.
|
|
4
|
-
"description": "Servidor MCP oficial de APIEmpresas.es: datos de empresas españolas (CIF, BORME, administradores, KYB, riesgo) para Claude, Cursor y otros asistentes de IA",
|
|
3
|
+
"version": "1.3.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
5
|
"mcpName": "io.github.abasmartinc/apiempresas",
|
|
6
6
|
"type": "module",
|
|
7
7
|
"bin": {
|