apiempresas-mcp 1.3.0 → 1.4.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 +2 -1
- package/dist/index.js +27 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -12,6 +12,7 @@ Pregunta en lenguaje natural ("¿Mercadona está activa y quiénes son sus admin
|
|
|
12
12
|
| `search_companies` | Buscar empresas por nombre | Free |
|
|
13
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
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
|
+
| `verify_invoice_recipients` | Valida una lista de clientes (hasta 100) antes de facturarles: razón social y domicilio oficiales, estado y `invoice_hint` ok / revisar / no_facturar, con sus motivos; con `vat`, también VIES (hasta 20). Solo cobra las sociedades encontradas (desde 1.4.0) | Pro |
|
|
15
16
|
| `get_borme_history` | Actos publicados en el BORME | Pro |
|
|
16
17
|
| `get_risk_profile` | Perfil de riesgo a partir del BORME | Business |
|
|
17
18
|
| `get_public_contracts` | Contratos públicos adjudicados | Business |
|
|
@@ -83,7 +84,7 @@ Con `APIEMPRESAS_BASE_URL=https://apiempresas.es/api/sandbox/v1` las llamadas no
|
|
|
83
84
|
|
|
84
85
|
## English
|
|
85
86
|
|
|
86
|
-
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.
|
|
87
|
+
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, bulk tax ID checks of invoice recipients (`verify_invoice_recipients`), 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.
|
|
87
88
|
|
|
88
89
|
## Licencia
|
|
89
90
|
|
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.4.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;
|
|
@@ -187,6 +187,32 @@ export function crearServidor() {
|
|
|
187
187
|
method: 'POST',
|
|
188
188
|
body: JSON.stringify({ items: names.map((name) => (province ? { name, province } : { name })) }),
|
|
189
189
|
}));
|
|
190
|
+
// 1.4.0 (26-10-2026): igual que en el servidor remoto (app/Libraries/McpServer.php)
|
|
191
|
+
server.registerTool('verify_invoice_recipients', {
|
|
192
|
+
title: 'Validar NIF de clientes para facturar',
|
|
193
|
+
description: "Valida una LISTA de clientes (hasta 100) antes de emitirles facturas (Verifactu, factura electrónica): por cada NIF, si el formato es válido, si la sociedad consta, su razón social y domicilio oficiales, su estado y, si das el nombre que tienes guardado, si coincide. Devuelve invoice_hint ok / revisar / no_facturar con los motivos (extinguida, absorbida, en concurso, nombre distinto, NIF de ejemplo...). Úsala para revisar la cartera de clientes de un programa de facturación o ERP; para dar de alta a un solo cliente con más detalle, verify_company. No sustituye al censo de la AEAT. Plan Pro, Business o saldo; gasta 1 consulta por sociedad encontrada (lo que no consta no se cobra). Bulk VAT/tax ID check of invoice recipients.",
|
|
194
|
+
inputSchema: {
|
|
195
|
+
items: z
|
|
196
|
+
.array(z.object({
|
|
197
|
+
cif: z.string().min(1).describe('NIF del cliente (CIF, DNI o NIE)'),
|
|
198
|
+
name: z.string().optional().describe('Razón social que tienes guardada, para comprobar que coincide con la oficial'),
|
|
199
|
+
ref: z.string().optional().describe('Tu identificador del cliente; se devuelve tal cual'),
|
|
200
|
+
}))
|
|
201
|
+
.min(1)
|
|
202
|
+
.max(100)
|
|
203
|
+
.describe('Clientes a validar'),
|
|
204
|
+
vat: z.boolean().optional().describe('true para comprobar además el NIF-IVA en VIES (solo con 20 clientes o menos)'),
|
|
205
|
+
},
|
|
206
|
+
annotations: soloLectura,
|
|
207
|
+
}, async ({ items, vat }) => {
|
|
208
|
+
if (vat && items.length > 20) {
|
|
209
|
+
return texto('La comprobación en VIES (vat) solo admite 20 clientes por llamada. Quita vat o divide la lista.', true);
|
|
210
|
+
}
|
|
211
|
+
return llamar('/companies/verify/batch', {
|
|
212
|
+
method: 'POST',
|
|
213
|
+
body: JSON.stringify(vat ? { items, vat: true } : { items }),
|
|
214
|
+
});
|
|
215
|
+
});
|
|
190
216
|
server.registerTool('get_borme_history', {
|
|
191
217
|
title: 'Historial del BORME',
|
|
192
218
|
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.",
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "apiempresas-mcp",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.4.0",
|
|
4
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",
|