Metadata-Version: 2.4
Name: klaren-mcp
Version: 0.1.2
Summary: MCP server for Klaren — French companies, directors & associations directory
Project-URL: Homepage, https://klaren.fr
Project-URL: Repository, https://github.com/klaren-fr/klaren-mcp
License-Expression: MIT
Keywords: entreprises,french-companies,inpi,insee,klaren,mcp,siren,siret
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp[cli]>=1.9.0
Description-Content-Type: text/markdown

# klaren-mcp

MCP server for **Klaren** — the French public directory of companies, directors and associations.

Data sourced from the Registre National des Entreprises (INPI), the SIRENE repertory (INSEE) and the Répertoire National des Associations (RNA).

## Available tools

| Tool | Description |
|------|-------------|
| `rechercher_entreprises` | Search companies by name, SIREN, activity or location |
| `fiche_entreprise` | Full company profile by SIREN number |
| `rechercher_dirigeants` | Search company directors by name |
| `fiche_dirigeant` | Director profile with all mandates |
| `rechercher_associations` | Search associations (loi 1901) |
| `fiche_association` | Full association profile by RNA identifier |
| `autocomplete` | Quick multi-source autocomplete |

## Installation

```bash
pipx install klaren-mcp
```

Or with pip:

```bash
pip install klaren-mcp
```

## Claude Desktop configuration

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "klaren": {
      "command": "klaren-mcp"
    }
  }
}
```

Restart Claude Desktop, then ask questions like:

- *"Donne-moi les informations sur l'entreprise SIREN 542051180"*
- *"Recherche les entreprises de développement logiciel à Lyon"*
- *"Qui sont les dirigeants de TotalEnergies ?"*

## Environment variables

| Variable | Default | Description |
|----------|---------|-------------|
| `KLAREN_API_URL` | `https://klaren.fr` | API base URL |
| `KLAREN_API_KEY` | *(none)* | Optional API key for higher rate limits |

## Links

- Website: [klaren.fr](https://klaren.fr)
- Remote MCP endpoint (SSE): `https://klaren.fr/api/mcp/rpc/sse`

<!-- mcp-name: io.github.ccamborde/klaren-mcp -->
