Contents
Documentation Projects search
projects-search
2 credits per call Read-only mairies
Find French communes by their projects: State-funded investments and permits they requested, by theme, words, year, department or size.
When to use it. E.g. communes of department 38 that got State funding for a school since 2024: theme schools-childhood, kind subsidy, since_year 2024. Words search the subjects (e.g. 'cantine', 'éclairage LED', 'gymnase'). One page of at most 25 projects, most recent first, with the town hall contacts.
Credits are taken when the call starts and given back in full if the tool fails, times out or is refused by the service behind it.
Ask your assistant
Once the server is connected, a request in plain words is enough. For example:
Use Mairies de France to find French communes by their projects: State-funded investments and permits they requested, by theme, words, year, department or size.
Examples
Most clients only need the server address and a sign-in: see Connect. Clients configured by a file take the first block. Your assistant then writes the second one by itself.
{
"mcpServers": {
"mairies-de-france": {
"url": "https://mairies.vosfichiers.com/mcp"
}
}
}
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "projects-search",
"arguments": {
"limit": 10,
"offset": 0,
"kind": "any",
"commune_only": true
}
}
}
Put an API key in the API_KEY environment variable first. Create a key
curl -X POST https://mairies.vosfichiers.com/api/v1/projects-search \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"limit": 10,
"offset": 0,
"kind": "any",
"commune_only": true
}'
Put an API key in the API_KEY environment variable first. Create a key
import json
import os
import urllib.request
payload = {
"limit": 10,
"offset": 0,
"kind": "any",
"commune_only": True,
}
request = urllib.request.Request(
"https://mairies.vosfichiers.com/api/v1/projects-search",
data=json.dumps(payload).encode(),
headers={
"Authorization": "Bearer " + os.environ["API_KEY"],
"Content-Type": "application/json",
},
method="POST",
)
with urllib.request.urlopen(request) as response:
print(json.load(response))
Put an API key in the API_KEY environment variable first. Create a key
const response = await fetch("https://mairies.vosfichiers.com/api/v1/projects-search", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"limit": 10,
"offset": 0,
"kind": "any",
"commune_only": true
}),
});
console.log(await response.json());
Input
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| limit | integer | optional | 10 | Rows per page, 25 at most. ≥ 1≤ 25 |
| offset | integer | optional | 0 | Rows to skip, for the next page. ≥ 0≤ 50000 |
| department | string | optional | none | Department code, e.g. 38, 2A or 974. pattern ^(\d{2}|2A|2B|97\d)$ |
| name | string | optional | none | Part of the commune name. 2 to 80 characters |
| population_min | integer | optional | none | Minimum population. ≥ 0 |
| population_max | integer | optional | none | Maximum population. ≥ 0 |
| profile | string | optional | none | Keep only communes with this profile: rurale, montagne, touristique, qpv, petites-villes-de-demain, villages-d-avenir. pattern ^(rurale|montagne|touristique|qpv|petites-villes-de-demain|villages-d-avenir)$ |
| has_website | boolean | optional | none | True: only communes with a website. |
| theme | enum | optional | none | Theme of the project. one of "schools-childhood", "public-buildings", "energy", "street-lighting", "roads-mobility", "water-sanitation", "environment-nature", "sport", "culture-heritage", "health-social", "security", "digital", "planning-urbanism", "economy-tourism", "general-services" |
| words | string | optional | none | Words. 3 to 80 characters |
| kind | enum | optional | "any" | subsidy, permit or any. one of "any", "subsidy", "permit" |
| since_year | integer | optional | none | First year. ≥ 2013≤ 2100 |
| commune_only | boolean | optional | true | True: only projects carried by the commune itself. |
Output
A JSON object whose fields depend on the request; this tool declares no fixed shape.
Try it
Run this tool from your account, with a form built from the fields above. A run is a real call: it costs 2 credits.
Open in the playground