MCP Recherche d'entreprises
Búsqueda de empresas de MCP
Este MCP (módulo de conexión API) le permite interactuar con la API de búsqueda empresarial proporcionada por data.gouv.fr.
Descripción
La API de búsqueda empresarial le permite buscar y encontrar empresas francesas. Ofrece dos tipos de búsqueda:
Búsqueda de texto (nombre, dirección, líderes y funcionarios electos)
Búsqueda geográfica
Related MCP server: MCP INPI
Características
El MCP le permite:
Búsqueda de empresas por diferentes criterios
Filtrar resultados por múltiples parámetros
Acceda a información esencial de la empresa (nombre, código SIREN, SIRET, NAF)
Realizar búsquedas geográficas alrededor de un punto con los siguientes parámetros:
Latitud y longitud del punto de búsqueda
Radio de búsqueda (hasta 50 km)
Filtros de actividad (código NAF, sección de actividad)
Paginación de resultados
Fuente
Este MCP se basa en la API oficial data.gouv.fr: API de búsqueda empresarial
Limitaciones
La API tiene algunas limitaciones:
No proporciona acceso a predecesores y sucesores de un establecimiento
No permite el acceso a empresas no difundibles
No permite el acceso a empresas a las que se les ha denegado el registro en el RCS
El radio de búsqueda geográfica está limitado a un máximo de 50 km.
Limitaciones técnicas
Límite de 7 llamadas por segundo
Disponibilidad: 100% durante el último mes
Acceso: Abierto a todos
Usar
Como usuario
La forma más fácil de utilizar este MCP es a través de npx :
npx mcp-recherche-entreprisesComo desarrollador
Instalación de dependencias:
npm installConstrucción del proyecto:
npm run buildEste comando hará lo siguiente:
Compilar archivos TypeScript en JavaScript
Colóquelos en la carpeta
dist/Hacer que los archivos JavaScript sean ejecutables
Puesta en marcha :
Para iniciar el servidor en modo de desarrollo con el Inspector MCP (recomendado para desarrollo):
npm run devPara iniciar el servidor sin el Inspector:
npm startEl Inspector MCP proporciona una interfaz gráfica para probar y depurar solicitudes MCP en tiempo real.
Usar con cursor
Para usar este MCP en Cursor, agregue la siguiente configuración a su archivo .cursor/settings.json :
{
"mcpServers": {
"recherche-entreprises": {
"command": "npx mcp-recherche-entreprises"
}
}
}Esta configuración permitirá que Cursor utilice automáticamente este MCP para búsquedas comerciales.
Recursos de MCP para colaboradores
Documentación oficial
Herramientas de desarrollo
Inspector MCP : herramienta de depuración y análisis
Mejores prácticas
Utilice el SDK de TypeScript para la implementación
Seguir las convenciones del código del proyecto
Implementar un manejo robusto de errores
Documentar claramente la API
Mantener la compatibilidad con futuras versiones
Pruebas y depuración
Uso del inspector para la depuración
Implementar pruebas unitarias
Verificar el cumplimiento de la especificación MCP
Analizar el rendimiento con las herramientas adecuadas
Licencia
Este proyecto está licenciado bajo la licencia MIT. Consulte el archivo LICENCIA para obtener más detalles.
Contribución
¡Las contribuciones son bienvenidas! Consulte nuestra guía de contribución para obtener más información sobre cómo contribuir a este proyecto.
Available Tools
2 toolsrechercher_entrepriseC
Recherche des entreprises françaises selon de nombreux critères (nom, activité, localisation, etc.).
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | Termes de la recherche (dénomination et/ou adresse, dirigeants, élus) | |
| activite_principale | No | Le code NAF ou code APE, un code d'activité suivant la nomenclature de l'INSEE. Ce paramètre accepte une valeur unique ou une liste de valeurs séparées par des virgules. Il ne s'applique qu'à l'unité légale, et non à ses établissements. | |
| section_activite_principale | No | Section de l'activité principale (A à U) selon la nomenclature NAF. | |
| categorie_entreprise | No | Catégorie d'entreprise de l'unité légale (PME, ETI, GE). | |
| nature_juridique | No | Catégorie juridique de l'unité légale (code INSEE). | |
| etat_administratif | No | État administratif de l'entreprise (A: Active, C: Cessée). | |
| tranche_effectif_salarie | No | Tranche d'effectif salarié de l'entreprise (ex : 10-19, 20-49, etc.). | |
| code_postal | No | Code postal en 5 chiffres. Ce paramètre filtre sur les établissements et accepte une valeur unique ou une liste de valeurs séparées par des virgules. | |
| code_commune | No | Code commune INSEE en 5 caractères. Ce paramètre filtre sur les établissements et accepte une valeur unique ou une liste de valeurs séparées par des virgules. | |
| departement | No | Code de département en deux ou trois chiffres. Ce paramètre filtre sur les établissements et accepte une valeur unique ou une liste de valeurs séparées par des virgules. | |
| region | No | Code de région en deux chiffres. Ce paramètre filtre sur les établissements et accepte une valeur unique ou une liste de valeurs séparées par des virgules. | |
| epci | No | Code EPCI (établissement public de coopération intercommunale). Ce paramètre filtre sur les établissements et accepte une valeur unique ou une liste de valeurs séparées par des virgules. | |
| est_association | No | Uniquement les entreprises ayant un identifiant d'association ou une nature juridique avec mention 'association'. | |
| est_entrepreneur_individuel | No | Uniquement les entreprises individuelles. | |
| est_ess | No | Uniquement les entreprises d'économie sociale et solidaire (ESS). | |
| est_service_public | No | Uniquement les structures reconnues comme administration (service public). | |
| est_bio | No | Uniquement les entreprises ayant un établissement certifié par l'agence bio. | |
| est_rge | No | Uniquement les entreprises ayant au moins un établissement RGE (Reconnu Garant de l'Environnement). | |
| est_finess | No | Uniquement les entreprises ayant au moins un établissement FINESS (établissements sanitaires et sociaux). | |
| est_qualiopi | No | Uniquement les entreprises certifiées Qualiopi (organismes de formation). | |
| est_societe_mission | No | Uniquement les sociétés à mission (article L.210-10 du code de commerce). | |
| nom_personne | No | Nom d'un dirigeant ou élu (personne physique ou morale). | |
| prenoms_personne | No | Prénom(s) d'un dirigeant ou élu (personne physique). | |
| type_personne | No | Type de personne recherchée : dirigeant ou élu. | |
| ca_min | No | Chiffre d'affaires minimum (en euros). | |
| ca_max | No | Chiffre d'affaires maximum (en euros). | |
| resultat_net_min | No | Résultat net minimum (en euros). | |
| resultat_net_max | No | Résultat net maximum (en euros). | |
| page | No | Numéro de page des résultats (défaut : 1). | |
| per_page | No | Nombre de résultats par page (1 à 25, défaut : 10). | |
| minimal | No | Retourne une réponse minimale (sans tous les champs détaillés). | |
| include | No | Champs à inclure avec minimal=true (complements, dirigeants, finances, matching_etablissements, siege, score). |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so the description must disclose behavioral traits. It only says 'searches many criteria' without mentioning pagination, rate limits, response format, or any side effects. This is insufficient for an agent to understand the tool's behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence, concise and front-loaded. It conveys the core purpose without extraneous text. However, it could be slightly more informative while maintaining brevity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (32 parameters) and the absence of output schema, the description is too brief. It lacks details about return values, pagination, and API source. The sibling tool's presence also suggests a need for clearer context on when to use this one.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% coverage with detailed descriptions for all 32 parameters. The description adds no new meaning beyond 'numerous criteria'. Baseline 3 is appropriate as the schema handles the parameter documentation.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it searches French companies using multiple criteria like name, activity, location. It includes examples, but does not explicitly differentiate from the sibling tool 'rechercher_entreprise_geographiques', which likely focuses on geographic search.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives. Given the sibling tool exists, explicit context or when-not-to-use instructions are missing. The description does not mention any prerequisites or scenario-specific advice.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
rechercher_entreprise_geographiquesB
Recherche des entreprises autour d'un point géographique (latitude, longitude, rayon, etc.).
| Name | Required | Description | Default |
|---|---|---|---|
| lat | Yes | Latitude du point de recherche | |
| long | Yes | Longitude du point de recherche | |
| radius | No | Rayon de recherche en km (max 50km) | |
| activite_principale | No | Code NAF ou code APE | |
| section_activite_principale | No | Section de l'activité principale (A à U) | |
| page | No | Numéro de page des résultats (défaut : 1). | |
| per_page | No | Nombre de résultats par page (1 à 25, défaut : 10). | |
| minimal | No | Retourne une réponse minimale (sans tous les champs détaillés). | |
| include | No | Champs à inclure avec minimal=true (complements, dirigeants, finances, matching_etablissements, siege, score). |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must convey behavioral traits. It only mentions basic parameters but lacks details on pagination, sorting, error handling, or result behavior (e.g., ordering by distance). The vague 'etc.' indicates incomplete disclosure.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single short sentence, which is concise but lacks structure. It uses 'etc.' which is vague and unprofessional.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool has 9 parameters, no output schema, and no annotations, the description is insufficient. It omits details on optional filters (activity types, pagination, minimal response) and does not explain the response structure.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all parameters. The description adds minimal extra meaning beyond mentioning lat, lon, radius, and 'etc.' Baseline of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool searches for companies around a geographic point, specifying key parameters (latitude, longitude, radius). It distinguishes from sibling tool 'rechercher_entreprise' which likely lacks geographic constraints.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives, nor any exclusions or context. It merely describes what the tool does without usage context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
TDQS
Les deux outils ont des finalités clairement distinctes : le premier permet une recherche générale par critères (nom, activité, localisation), le second se limite à une recherche géographique autour d'un point. Il n'y a pas de chevauchement.
Les noms suivent un schéma cohérent : 'rechercher_entreprise' comme base, avec un qualificatif pour la variante géographique. La convention snake_case est uniforme et prédictible.
Avec seulement 2 outils, le serveur est très ciblé. Pour un service de recherche d'entreprises, cela peut suffire si l'objectif est limité à la recherche, mais le nombre est à la limite inférieure de ce qui est raisonnable.
Les deux modes de recherche (général et géographique) couvrent les cas d'usage courants. Il manque peut-être une recherche par identifiant unique (SIRET) ou des opérations CRUD, mais dans le cadre d'un serveur dédié à la recherche, l'ensemble est presque complet.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
French & European company registry for AI agents: KYB, sanctions, annual accounts. x402, no API key.
Search French companies: financials, directors, ownership, M&A and insolvency events.
INSEE MCP — France's SIRENE business registry (INSEE).
French Companies MCP — recherche-entreprises.api.gouv.fr
Related MCP Servers
- FlicenseBqualityDmaintenanceEnables searching companies in the SIRENE database using SIREN, SIRET, or company name via the INSEE API.1
- FlicenseNot gradedqualityBmaintenanceEnables querying French business registers (RNE, BODACC) and trademarks via INPI APIs. Provides tools to search companies, retrieve legal status, directors, beneficial owners, collective procedures, and trademark details.
- FlicenseNot gradedqualityDmaintenanceEnables searching for French companies using the official data.gouv.fr API, with filters for name, location, activity, and certifications.1
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to search and retrieve detailed profiles of 25 million French companies from the official government registry, including directors, activity codes, and establishment data, without requiring an API key.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/yoanbernabeu/mcp-recherche-entreprises'
If you have feedback or need assistance with the MCP directory API, please join our Discord server