api-territoire-mcp
v0.1.2
Published
MCP server for API Territoire — French territorial data (demographics, real estate, employment, education, health, risks) for 35,000+ communes
Maintainers
Readme
api-territoire-mcp
MCP (Model Context Protocol) server for API Territoire — access French territorial data directly from AI assistants like Claude, ChatGPT, Cursor, and more.
Query demographics, real estate markets, employment, education, health, risks, and environment data for 35,000+ French communes, powered by INSEE, DVF, France Travail, and 30+ public data sources.
Quick Start
1. Get an API key
Request a free key at api-territoire.fr/keys/request
2. Configure your MCP client
Add this to your MCP configuration file (claude_desktop_config.json, .cursor/mcp.json, etc.):
{
"mcpServers": {
"api-territoire": {
"command": "npx",
"args": ["-y", "api-territoire-mcp"],
"env": {
"API_KEY": "at_live_your_key_here"
}
}
}
}That's it. Your AI assistant can now query French territorial data.
Available Tools
address_analyze
Comprehensive territorial analysis for any French address. Returns:
- Geocoding and commune identification
- Real estate market data (DVF transactions, median prices, price per m2)
- Property price estimation with confidence level
- Cadastre parcel information
- Local context: demographics, employment, education, health, security, environment, public services, connectivity, natural risks, urban planning, and available training programs
"Analyse le 12 rue de la Paix, Paris"simulate_loan
Mortgage loan simulation using current French interest rates:
- Monthly payment calculation
- Full amortization schedule
- Interest rate from Banque de France data
"Simule un prêt pour un bien à 250000€ avec 50000€ d'apport sur 20 ans"list_metiers
Search French job professions (ROME codes) with salary data extracted from France Travail job offers:
- ROME code and job title
- Median salary range (min/max)
- Number of offers analyzed
"Quels sont les salaires pour les métiers d'infirmier ?"search_opportunities
Find real estate listings within your budget near active job offers for a given profession. Spatial matching between BienIci property listings and geolocated France Travail job offers:
- Property details (price, surface, rooms, DPE, photo)
- Nearest matching job offer
- Distance between property and workplace
"Trouve des maisons à moins de 200000€ près d'offres d'emploi de développeur (code ROME M1805) dans un rayon de 30km"Data Sources
| Source | Data | |--------|------| | INSEE (Melodi) | Population, income, employment, education, housing, businesses | | DVF (Cerema) | Real estate transactions and price statistics | | France Travail | Job offers, ROME professions, salary data | | BienIci | Active property listings | | Banque de France | Mortgage interest rates | | IGN / Geoplateforme | Administrative boundaries, cadastre, IRIS | | HubEau | Water quality | | GeoRisques | Natural and industrial risks | | ARCEP | Internet connectivity (fiber, 4G/5G) | | DREES | Healthcare access indicators | | Education nationale | Schools and IPS scores | | Meteo-France | Climate normals | | + 20 more | Energy, air quality, urban planning, public services... |
Links
License
MIT
