# 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](https://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.):

```json
{
  "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

- [Homepage](https://api-territoire.fr)
- [REST API Documentation](https://api-territoire.fr/docs)
- [MCP Documentation](https://api-territoire.fr/docs/mcp)
- [Request an API Key](https://api-territoire.fr/keys/request)

## License

MIT