mcp-french-open-data
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HOST | No | HTTP bind address. | 127.0.0.1 |
| PORT | No | HTTP bind port. | 3000 |
| MCP_AUTH | No | Set to none to serve HTTP without a key, as an explicit opt-in. | |
| LOG_LEVEL | No | Log level: debug, info, warn or error. Logs go to stderr as JSON lines. | info |
| MCP_API_KEY | No | Required for HTTP; at least 16 characters. Accepted as Authorization: Bearer <key> or x-api-key: <key>. | |
| GEO_BASE_URL | No | Override the upstream geo base URL, e.g. for a proxy or cache. | |
| ALLOWED_HOSTS | No | Comma-separated Host allow-list (DNS-rebinding protection) when binding to 0.0.0.0. | |
| MCP_TRANSPORT | No | Transport to use: stdio or http. --http on the command line also selects HTTP. | stdio |
| GEOCODING_BASE_URL | No | Override the upstream geocoding base URL, e.g. for a proxy or cache. | |
| ENTREPRISES_BASE_URL | No | Override the upstream entreprises base URL, e.g. for a proxy or cache. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_addressA | Geocode a free-text French address with the national address base (BAN, via the IGN Géoplateforme). Returns ranked matches with label, postcode, city, INSEE code, relevance score (0-1) and WGS84 coordinates. Use this to normalise or locate an address. |
| reverse_geocodeA | Find the nearest French addresses to a latitude/longitude (WGS84). Returns addresses with their distance in metres. Coverage: France including overseas départements. |
| search_companyA | Search the French company register (SIRENE/RNE via API Recherche d'entreprises) by name, address, leader name or SIREN/SIRET. Returns SIREN, name, status, NAF activity code, head office and establishment counts. Follow up with get_company for details. |
| get_companyA | Fetch one French company by its 9-digit SIREN: legal form, VAT number, creation and closure dates, head office, leaders and published yearly revenue/net income. |
| list_communesA | Look up French communes by name, postcode or département (geo.api.gouv.fr). Returns INSEE code, postcodes, département, région and population. Give at least one filter. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: reverse_geocode (coords→address) vs search_address (text→coords) are opposite directions, and get_company (fetch by SIREN) vs search_company (search register) are cleanly separated by lookup versus discovery. list_communes is a separate administrative resource entirely. No overlap or confusion.
All five names follow a strict verb_noun snake_case pattern: reverse_geocode, get_company, search_address, search_company, list_communes. Verbs (reverse, get, search, list) are standard and predictable, and resource nouns are consistent.
Five tools is well-scoped for a French open-data server covering addresses, companies, and communes. Each tool earns its place with no redundancy, and the surface is neither thin nor bloated.
The set covers forward and reverse geocoding, company search and detail retrieval, and commune lookup, forming a solid lifecycle for the domain. Minor gaps exist (e.g. no establishment/SIRET-level lookup or batch geocoding), but agents can work around these via the existing tools.