INSEE Server

MCP (Model Context Protocol) server for accessing INSEE data via the SIRENE API, BDM, and official nomenclatures.

One-line Installation

With uv (recommended)

# Install and launch directly
API_KEY="your_insee_api_key" uv run --with insee-mcp insee-mcp

or if you prefer to use uvx

# Install and launch directly
API_KEY="your_insee_api_key" uvx insee-mcp insee-mcp

Standard MCP Configuration

Add this to your MCP configuration (e.g., Claude Desktop, or Copilot):

{
  "mcpServers": {
    "insee": {
      "command": "uvx",
      "args": ["insee-mcp", "insee-mcp"],
      "env": {
        "API_KEY": "your_insee_api_key"
      }
    }
  }
}

With pipx

API_KEY="your_insee_api_key" pipx run --spec git+https://github.com/KerryanOPMace/mcp-insee.git insee-mcp

Quick Installation

Direct Installation (recommended)

# Install directly from GitHub
pip install git+https://github.com/KerryanOPMace/mcp-insee.git

# Set your INSEE API key
export API_KEY="your_insee_api_key"

# Start the server
insee-mcp

Installation with pipx (isolated)

# Install with pipx (isolated environment)
pipx install git+https://github.com/KerryanOPMace/mcp-insee.git

# Set the API key
export API_KEY="your_insee_api_key"

# Start the server
insee-mcp

Developer Installation

# Clone the repository
git clone https://github.com/KerryanOPMace/mcp-insee.git
cd mcp-insee

# Install in development mode
pip install -e .

If you wish to contribute to the project, please create issues and branches. You can merge request and then a supervisor will review it before merging

Configuration

INSEE API Key

You must obtain an API key from the INSEE API portal and configure it:

Linux/Mac:

export API_KEY="your_insee_api_key"

Windows (PowerShell):

$env:API_KEY="your_insee_api_key"

Windows (CMD):

set API_KEY=your_insee_api_key

Available Tools

• search_company: Search for companies in the SIRENE database
  • By SIREN, SIRET, or company name
  • Fuzzy search available

STREAMABLE-HTTP TRANSPORT

Server Access

Once started, the MCP server is accessible at:

• URL: http://127.0.0.1:8000/mcp
• Transport: Streamable HTTP

Client Test

from fastmcp import Client
import asyncio

async def test():
    client = Client("http://127.0.0.1:8000/mcp")
    async with client:
        # List tools
        tools = await client.list_tools()
        print(tools)
        
        # Search for a company
        result = await client.call_tool("search_company", {
            "siret": "44302124100072"
        })
        print(result)

asyncio.run(test())

Requirements

• Python 3.8+
• Valid INSEE API key
• Internet access for API requests

STDIO TRANSPORT

Server Access

Once started, the MCP server runs locally according to the standard io protocol

Client Test

from fastmcp import Client
import asyncio

async def test():
    client = Client("http://127.0.0.1:8000/mcp")
    async with client:
        # List tools
        tools = await client.list_tools()
        print(tools)
        
        # Search for a company
        result = await client.call_tool("search_company", {
            "siret": "44302124100072"
        })
        print(result)

asyncio.run(test())

Requirements

• Python 3.8+
• Valid INSEE API key
• Internet access for API requests

License

MIT License