apiempresas-mcp 1.2.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 CHANGED
@@ -12,9 +12,11 @@ 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 |
19
+ | `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 |
18
20
  | `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
21
  | `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
22
  | `get_usage` | Plan, consultas disponibles y saldo de créditos (gratis; no funciona en el Sandbox) | Todos |
@@ -82,7 +84,7 @@ Con `APIEMPRESAS_BASE_URL=https://apiempresas.es/api/sandbox/v1` las llamadas no
82
84
 
83
85
  ## English
84
86
 
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.
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.
86
88
 
87
89
  ## Licencia
88
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.2.0';
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.",
@@ -209,6 +235,17 @@ export function crearServidor() {
209
235
  },
210
236
  annotations: soloLectura,
211
237
  }, async ({ cif, page, limit }) => llamar(`/companies/contracts?${qs({ cif: limpiarCif(cif), page: page ?? 1, limit: limit ?? 20 })}`));
238
+ // 1.3.0 (20-10-2026): igual que en el servidor remoto (app/Libraries/McpServer.php)
239
+ server.registerTool('get_subsidies', {
240
+ title: 'Subvenciones y ayudas públicas',
241
+ 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.",
242
+ inputSchema: {
243
+ cif: cifSchema,
244
+ year: z.number().int().min(2000).optional().describe('Solo las concesiones de ese año'),
245
+ limit: z.number().int().min(1).max(50).optional().describe('Concesiones por página (por defecto 20)'),
246
+ },
247
+ annotations: soloLectura,
248
+ }, async ({ cif, year, limit }) => llamar(`/companies/subsidies?${qs({ cif: limpiarCif(cif), year, limit: limit ?? 20 })}`));
212
249
  server.registerTool('search_tenders', {
213
250
  title: 'Licitaciones públicas abiertas',
214
251
  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.",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "apiempresas-mcp",
3
- "version": "1.2.0",
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",