Poligraph MCP Server

Serveur MCP (Model Context Protocol) qui expose les données publiques de Poligraph comme tools pour les clients MCP compatibles.

Permet aux journalistes, chercheurs et citoyens d'interroger des données documentées sur la vie politique française en langage naturel.

Utilisation rapide

Serveur distant

Le serveur HTTP Streamable est déployé à l'adresse :

https://poligraph-mcp.vercel.app/mcp

Claude Desktop

Ajoutez dans votre configuration MCP :

{
  "mcpServers": {
    "poligraph": {
      "type": "streamable-http",
      "url": "https://poligraph-mcp.vercel.app/mcp"
    }
  }
}

Claude Code

claude mcp add poligraph --transport http https://poligraph-mcp.vercel.app/mcp

ChatGPT

Le parcours principal prévu pour ChatGPT est l’OpenAI Plugins Directory, via une soumission MCP-only. Un parcours facultatif et distinct vers le GPT Store reste possible avec un GPT personnalisé et une Action OpenAPI. L’issue poligraph#737 concerne uniquement ce second parcours et ne bloque pas la soumission MCP. PoliGraph n’est pas encore présenté comme soumis, accepté ou publié dans ces annuaires.

Le dossier technique marketplace rassemble les éléments préparatoires et les points restant à traiter.

Le serveur expose déjà les métadonnées MCP utiles aux clients compatibles :

• annotations avec readOnlyHint: true sur tous les tools ;

• _meta pour les états d'invocation ;

• structuredContent en complément du rendu textuel.

Installation locale (stdio)

git clone https://github.com/ironlam/poligraph-mcp.git
cd poligraph-mcp
npm install
npm run build

Puis configurez votre client MCP pour exécuter :

{
  "mcpServers": {
    "poligraph": {
      "command": "node",
      "args": ["/chemin/absolu/vers/poligraph-mcp/build/index.js"]
    }
  }
}

Related MCP server: mpc-judilibre

Tools disponibles (19)

Politiciens

Affaires judiciaires

Votes parlementaires

Mandats

Partis politiques

Fact-checks

Élections

Géographie

Recherche

Architecture

src/
├── index.ts
├── server.ts
├── http.ts
├── api.ts                # client API borné : timeout, taille, erreurs
├── editorial.ts          # règles de rendu fail-safe du contrat public
├── tools/
│   ├── politicians.ts
│   ├── affairs.ts
│   ├── votes.ts
│   ├── legislation.ts
│   ├── factchecks.ts
│   ├── parties.ts
│   ├── elections.ts
│   ├── mandates.ts
│   └── departments.ts
└── tests/
    ├── editorial.test.ts
    └── api-contract.test.ts
api/
└── mcp.ts

Transports supportés :

• stdio pour un client local ;

• HTTP Streamable pour le serveur Express ou Vercel.

Développement

npm run dev
npm run build
npm run start:http
npm run inspect
npm run test:unit
npm run test:contract
npm run test:build

test:unit vérifie les invariants éditoriaux déterministes. test:contract effectue le smoke test contre l'API publique déployée.

Contrat éditorial public

Le MCP ne se connecte pas directement à la base de données et n'utilise ni service key ni endpoint d'administration. Il consomme exclusivement l'API publique Poligraph.

Pour les affaires judiciaires :

• seules les données publiées par le contrat public sont consommées ;

• le rôle (DIRECT, mention, victime, plaignant…) est distinct du statut de la procédure ;

• les libellés de statut, catégorie, prudence, certitude et maturité sont fournis par le contrat canonique Poligraph ;

• si cette sémantique canonique est absente, le MCP n'affiche pas le code interne comme signification éditoriale ;

• le total legacy tous rôles est exposé par le MCP sous legacyPublishedAffairsCountAllRoles, uniquement pour compatibilité structurée, et n'est pas présenté comme indicateur à charge ;

• les compteurs par rôle font foi pour la présentation.

Pour les données incomplètes :

• null ou champ absent ne signifie jamais 0 ou false ;

• un taux de participation n'est rendu que si son état de publication est explicitement AVAILABLE ;

• une date de prise de fonction n'est utilisée comme ancienneté que si le contrat la marque explicitement AVAILABLE.

Les champs textuels issus des sources publiques sont traités comme des données, jamais comme des instructions adressées au modèle.

Sources

Poligraph agrège des sources publiques, institutionnelles et éditoriales documentées, notamment l'Assemblée nationale, le Sénat, la HATVP, Wikidata et des organismes de fact-checking. Voir poligraph.fr/sources pour le détail.

Licence

MIT