MCP Business Search

This MCP (API Connection Module) allows you to interact with the Business Search API provided by data.gouv.fr.

Description

The Business Search API allows you to search and find French companies. It offers two types of searches:

Text search (name, address, leaders and elected officials)
Geographic search

Features

The MCP allows you to:

Search for companies by different criteria
Filter results by multiple parameters
Access essential company information (name, SIREN, SIRET, NAF code)
Perform geographic searches around a point with the following parameters:
- Latitude and longitude of the search point
- Search radius (up to 50km)
- Activity filters (NAF code, activity section)
- Results pagination

Source

This MCP is based on the official data.gouv.fr API: Business Search API

Limitations

The API has some limitations:

Does not provide access to predecessors and successors of an establishment
Does not allow access to non-disseminable companies
Does not allow access to companies that have been refused registration with the RCS
The geographic search radius is limited to a maximum of 50km

Technical limitations

Limit of 7 calls per second
Availability: 100% over the last month
Access: Open to all

Use

As a user

The easiest way to use this MCP is via npx :

npx mcp-recherche-entreprises

As a developer

Installing dependencies:

npm install

Project build:

npm run build

This command will:

Compile TypeScript files to JavaScript
Place them in the dist/ folder
Make JavaScript files executable

Startup :

To launch the server in development mode with the MCP Inspector (recommended for development):

npm run dev

To launch the server without the Inspector:

npm start

The MCP Inspector provides a graphical interface for testing and debugging MCP requests in real time.

Use with Cursor

To use this MCP in Cursor, add the following configuration to your .cursor/settings.json file:

{
  "mcpServers": {
    "recherche-entreprises": {
      "command": "npx mcp-recherche-entreprises"
    }
  }
}

This configuration will allow Cursor to automatically use this MCP for business searches.

MCP Resources for Contributors

Official documentation

Development tools

MCP TypeScript SDK
MCP Inspector - Debugging and Analysis Tool

Best practices

Use the TypeScript SDK for implementation
Follow project code conventions
Implement robust error handling
Clearly document the API
Maintain compatibility with future versions

Testing and debugging

Using the Inspector for Debugging
Implement unit tests
Check compliance with the MCP specification
Analyze performance with the appropriate tools

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contribution

Contributions are welcome! Check out our contribution guide for more information on how to contribute to this project.

MCP Recherche d'entreprises