apiempresas-mcp 1.1.0 → 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 (3) hide show
  1. package/README.md +2 -0
  2. package/dist/index.js +39 -20
  3. package/package.json +2 -2
package/README.md CHANGED
@@ -15,6 +15,8 @@ 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
+ | `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 |
18
20
  | `get_usage` | Plan, consultas disponibles y saldo de créditos (gratis; no funciona en el Sandbox) | Todos |
19
21
 
20
22
  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.1.0';
17
+ export const VERSION = '1.2.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: 'Datos de una empresa española a partir de su CIF/NIF: razón social, estado (activa, extinguida, en concurso…), ' +
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: 'Busca empresas españolas por nombre o razón social y devuelve las coincidencias con su CIF. ' +
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: 'Verificación KYB de una empresa en una sola llamada: si existe y está activa, si el nombre declarado coincide ' +
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: 'Encuentra el CIF de una lista de empresas a partir de sus nombres (hasta 100). Cada resultado es match, ' +
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: 'Actos publicados en el BORME (Boletín Oficial del Registro Mercantil) de una empresa: constitución, ' +
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: 'Perfil de riesgo de una empresa calculado a partir de sus publicaciones en el BORME (concursos, disoluciones, ' +
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: 'Contratos del sector público adjudicados a una empresa (Plataforma de Contratación del Sector Público). Plan Business.',
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,39 @@ 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
+ 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
+ });
223
242
  server.registerTool('get_usage', {
224
243
  title: 'Consumo de la cuenta',
225
- description: 'Plan de la cuenta, consultas usadas y disponibles, y saldo de créditos. No gasta consultas. No funciona en el Sandbox.',
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.",
226
245
  inputSchema: {},
227
246
  annotations: soloLectura,
228
247
  }, async () => llamar('/usage'));
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "apiempresas-mcp",
3
- "version": "1.1.0",
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.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
5
  "mcpName": "io.github.abasmartinc/apiempresas",
6
6
  "type": "module",
7
7
  "bin": {