Une API pour les agents

Les finances publiques françaises, servies en MCP : 24,4 M d’entités, 663 K subventions, 800 K comptes publics, 643 K mandats électifs.

Quinze outils. Les plus utiles s’appellent sans compte et sans payer, dans la limite d’un quota quotidien. Au-delà, un compte multiplie le quota par cinq, et les capacités coûteuses se règlent à l’acte en USDC.

Brancher Claude

Une commande, ou trois lignes de configuration.

Claude Code

claude mcp add --transport http aifr-donnees-publiques https://aifr.ai/mcp

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "aifr-donnees-publiques": {
      "type": "http",
      "url": "https://aifr.ai/mcp"
    }
  }
}

Vérifier, sans rien installer

curl -s -X POST https://aifr.ai/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

tools/list répond sans authentification : c’est ainsi qu’un agent nous découvre.

Les 15 outils

Prix en USDC par appel. public : sans compte · compte : jeton requis, gratuit · payant : réglé à l’acte au-delà du quota.

Outil	Accès	USDC	Ce qu’il fait
search_entities	public	0,0005	Chercher parmi 24,4 M d’entités
get_entity_profile	public	0,001	Fiche complète par SIREN
search_open_datasets	public	0,001	Chercher un jeu sur data.gouv.fr
inspect_open_dataset	public	0,001	Ressources d’un jeu de données
list_entity_subsidies	compte	0,002	Subventions perçues par une entité
get_public_finances	compte	0,002	Comptes DGFiP sur 25 exercices
search_public_officials	compte	0,002	Déclarations HATVP
list_entity_elected_officials	compte	0,002	Élus d’une collectivité
list_lobbyists	compte	0,002	Représentants d’intérêts
plan_dataset_ingestion	compte	0,005	Plan d’ingestion d’un fichier ouvert
list_top_beneficiaries	payant	0,003	Plus gros bénéficiaires
rank_entities_by_metric	payant	0,004	Classer les collectivités
get_subsidy_purpose_breakdown	payant	0,004	Bénéficiaires par objectif
ask_public_data_question	payant	0,02	Question en langage naturel
generate_entity_brief	payant	0,35	Note d’analyse rédigée

À quoi ça sert

Vérifier un bénéficiaire avant de contracter

Un agent de conformité résout le SIREN, lit la fiche, additionne les subventions reçues et remonte les mandats des dirigeants. Trois appels, moins d'un centime.

search_entitiesget_entity_profilelist_entity_subsidies

Situer une commune parmi ses pairs

Dette par habitant, part des charges de personnel, effort d'investissement : le classement porte sur la totalité des communes, pas sur un échantillon.

get_public_financesrank_entities_by_metric

Suivre une politique publique jusqu’à ses destinataires

Partir d'un objectif de subvention, obtenir la liste des bénéficiaires et la répartition par année.

get_subsidy_purpose_breakdownlist_top_beneficiaries

Absorber un jeu de données hétérogène

data.gouv.fr recense plus de 500 jeux de subventions, un par collectivité, chacun avec ses propres intitulés de colonnes. L'outil lit l'en-tête, propose une correspondance vers un modèle canonique et chiffre le taux de rejet avant tout chargement.

search_open_datasetsinspect_open_datasetplan_dataset_ingestion

Payer à l’acte, sans compte

Schéma x402 : l’appel non réglé répond 402 avec les rails acceptés ; on vire le montant, on rappelle avec la preuve.

1. Appeler l’outil. Réponse 402 portant accepts[] : réseau, montant atomique, adresse de règlement.
2. Virer le montant exact en USDC — sur Base ou sur Solana.
3. Rappeler avec l’en-tête X-PAYMENT(JSON base64 : {"network":…,"transaction":…}).

Le montant annoncé en 402 est celui qui est réglé — le catalogue, la carte d’agent et la porte de paiement dérivent d’une source unique. Une preuve de paiement n’est acceptée qu’une fois.

Tarifs (JSON) Carte d’agent Ce que nous achetons État du service llms.txt

Licence et limites

Toutes les données proviennent de sources publiques officielles (INSEE, DGFiP, HATVP, Commission européenne, DGCL) et sont redistribuées sous licence ouverte. Nous ne corrigeons pas les montants publiés, même douteux : les anomalies relevées sont documentées dans le rapport sur les données, et la structure exacte dans la carte du modèle.