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

Related MCP server: INSEE MCP Server

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

1. Installing dependencies:

npm install

2. Project build:

npm run build

This command will:

• Compile TypeScript files to JavaScript

• Place them in the dist/ folder

• Make JavaScript files executable

3. 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

• MCP Documentation

• MCP Specification

• Server Examples

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.