siret-mcp

Servidor MCP para los datos del registro francés de empresas. Pregunta por cualquier empresa francesa por nombre, SIREN o SIRET y obtén JSON limpio — con cada código del registro ya traducido a francés corriente.

El registro oficial te entrega "nature_juridique": "5710", "activite_principale": "62.01Z", "tranche_effectif_salarie": "12". Un LLM que recibe eso o bien adivina o bien alucina. Este servidor te entrega "Société par actions simplifiée (SAS)", "Programmation informatique", "20 à 49 salariés" — con el código original al lado para que la respuesta siga siendo comprobable.

Sin clave API. Sin cuenta.

Instalación

Claude Code

claude mcp add siret -- npx -y siret-mcp

Cursor — ~/.cursor/mcp.json:

{
  "mcpServers": {
    "siret": {
      "command": "npx",
      "args": ["-y", "siret-mcp"]
    }
  }
}

Claude Desktop — claude_desktop_config.json, el mismo bloque que Cursor.

Reinicia el cliente. Deberías ver cuatro herramientas.

Related MCP server: INSEE MCP Server

Prueba estos

• "¿Sigue activo el SIREN 552100554 y qué forma jurídica tiene?"

• "Busca empresas de software en Loire-Atlantique con más de 20 empleados."

• "¿Qué significa el código NAF 43.22A?"

• "Aquí tienes un SIRET de una factura: 55210055400015 — verifícalo y dime la dirección registrada."

• "Enumera todos los establecimientos de este SIREN e indica cuál es la sede central."

Herramientas

Además, un recurso siret://health que expone estadísticas de la caché.

Decisiones de diseño que conviene conocer

Los códigos siempre van acompañados de etiquetas. Todo campo codificado devuelve {code, label, exact, source}. exact: false significa que la etiqueta procede de un respaldo (una sección NAF en lugar de la clase precisa), de modo que un modelo puede matizar adecuadamente en lugar de afirmar una suposición como un hecho.

Los campos ausentes se indican por su nombre, no se devuelven como nulos. Cada perfil incluye un array missing. Ante "workforce": null, un modelo a menudo inventará un número de empleados. Ante "missing": ["workforce"], dice que el registro no dispone de ese dato.

Los errores se devuelven, no se lanzan. Los fallos se devuelven como JSON con un campo hint, para que el modelo pueda reintentar o reformular en lugar de morir a mitad de la conversación.

La caché es el producto, no una optimización. El servicio de origen limita las ráfagas de peticiones. Una caché con TTL de 6 horas (SIRENE_CACHE_TTL_MS) es lo que hace que esto sea utilizable en un bucle de agente que pregunta por la misma empresa nueve veces.

Cuatro herramientas, no doce. Cada herramienta extra cuesta contexto al modelo que llama y añade una forma de que se equivoque.

Limitaciones

• Las tablas de códigos son parciales. La NAF rev. 2 completa tiene ~732 códigos y la catégorie juridique ~300; este servidor incluye los habituales más un respaldo que se marca como aproximado (exact: false).

• Respaldado por recherche-entreprises.api.gouv.fr, no por INSEE Sirene v3. No requerir clave API significa que funciona de inmediato. La contrapartida son menos campos y ninguna lista exhaustiva de establecimientos.

• La caché es interna al proceso. Adecuada para un servidor stdio local, pero no para uno alojado multiinquilino.

Datos y atribución

Los datos proceden de la API Recherche d'Entreprises (DINUM), derivados de INSEE SIRENE, bajo Licence Ouverte. Los registros de directivos pueden incluir el año de nacimiento. Eres responsable de usar los datos conforme a la ley.

Desarrollo

git clone https://github.com/tbellicha/siret-mcp.git
cd siret-mcp
npm install
npm run build
npm test                 # node:test, offline
npm run test:live        # hits the real API
npm run typecheck

Licencia

MIT © 2026 tbellicha