Recherche d'entreprises

Provides access to data.gouv.fr's Enterprise Search API with text and geographic search capabilities for French companies.

typescript

13

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "yoanbernabeu-mcp-recherche-entreprises": {
      "command": "npx",
      "args": [
        "mcp-recherche-entreprises"
      ]
    }
  }
}

You can query the data.gouv.fr Enterprise Search API through this MCP to find and filter French companies. It supports text-based searches and geographic searches, returning essential company details and enabling refined filtering for efficient discovery.

How to use

To use this MCP with your MCP client, run the provided command to start a local server bridge and then issue search requests through your client. You can search by company name, address, directors, or elected representatives, and you can also perform geographic searches by providing a location, radius, and optional activity filters.

How to install

Prerequisites you need installed before starting:

Node.js (LTS version) with npm
A working MCP client or environment to run MCP commands

Step by step commands to set up and run the MCP server locally:

# 1. Install dependencies
npm install

# 2. Build the project (transpile TS to JS)
npm run build

# 3. Start in development mode with the MCP Inspector for debugging
npm run dev

# If you prefer to run the server without the Inspector, use
npm start

Available tools

textSearch

Performs a textual search across company denomination, address, directors, and elected representatives to locate matching French companies.

geoSearch

Executes geographic searches around a latitude/longitude point with a defined radius (up to 50 km) and optional activity filters (code NAF, business section).

filtering

Applies multiple filters on search results to refine the list of companies returned, including identifiers (SIREN, SIRET) and activity codes.

pagination

Supports paging through results to handle large result sets in a controlled manner.