Poligraph MCP Server

Serveur MCP (Model Context Protocol) qui expose les données de Poligraph comme tools pour Claude, ChatGPT et tout client MCP compatible.

Permet aux journalistes, chercheurs et citoyens de requêter les données politiques françaises en langage naturel.

Utilisation rapide

Serveur distant (aucune installation)

Le serveur est déployé sur Vercel et accessible directement :

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

Claude Desktop

Ajoutez dans votre fichier claude_desktop_config.json :

{
  "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 Apps

Le serveur est compatible avec ChatGPT Apps via le protocole MCP.

Créer un connector ChatGPT :

1. Allez sur platform.openai.com > Actions > Create new action

2. Sélectionnez MCP Server comme type de connector

3. Entrez l'URL du serveur :

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

4. Les 18 tools seront automatiquement détectés

5. Publiez l'action dans votre GPT ou App

Fonctionnalités ChatGPT :

• annotations : tous les tools sont marqués readOnlyHint: true (lecture seule)

• _meta OpenAI : messages de statut pendant l'invocation (ex: "Recherche de politiciens...")

• structuredContent : données JSON structurées en plus du texte markdown

Installation locale (stdio)

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

Ajoutez dans la configuration de votre client MCP :

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

Emplacement du fichier de config Claude Desktop :

• macOS : ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows : %APPDATA%\Claude\claude_desktop_config.json

• Linux : ~/.config/Claude/claude_desktop_config.json

Related MCP server: mpc-judilibre

Tools disponibles (18)

Politiciens

Affaires judiciaires

Votes parlementaires

Mandats

Partis politiques

Fact-checks

Elections

Géographie

Recherche

Architecture

src/
├── index.ts          # Point d'entrée CLI (transport stdio)
├── server.ts         # Factory MCP server & enregistrement des tools
├── http.ts           # Serveur Express (transport HTTP Streamable)
├── api.ts            # Client API (https://poligraph.fr)
├── tools/
│   ├── politicians.ts
│   ├── affairs.ts
│   ├── votes.ts
│   ├── legislation.ts
│   ├── factchecks.ts
│   ├── parties.ts
│   ├── elections.ts
│   ├── mandates.ts
│   └── departments.ts
└── tests/
    └── api-contract.test.ts
api/
└── mcp.ts            # Handler Vercel (serverless)

Transports supportés :

• stdio — Claude Desktop / Claude Code en local

• HTTP Streamable — serveur Express ou Vercel, compatible ChatGPT Actions

Développement

npm run dev          # Compilation en mode watch
npm run build        # Build production
npm run start:http   # Serveur HTTP local (port 3001)
npm run inspect      # Tester interactivement avec MCP Inspector
npm run test:build   # Build + tests de contrat API

Source des données

Toutes les données proviennent de sources officielles :

• Assemblée nationale

• Sénat

• HATVP

• Wikidata

Voir poligraph.fr/sources pour la liste complète.

Périmètre des affaires judiciaires

Les outils list_affairs, get_politician_affairs et les compteurs affairsCount n'exposent que les affaires publiées après validation éditoriale humaine sur poligraph.fr. Les brouillons, affaires archivées, exclues ou rejetées ne sont jamais retournés, ni directement ni via les agrégats. Le serveur MCP consomme exclusivement l'API publique : il hérite de ses filtres et n'y ajoute aucune donnée.

Le compteur affairsCount recense toutes les implications publiées (mis en cause, mentionné, victime, plaignant) ; la liste get_politician_affairs filtre par défaut sur les mises en cause directes (involvement=DIRECT).

Outre affairsCount (legacy, tous rôles confondus), la fiche politicien expose des compteurs par rôle : adverseAffairsCount (mis en cause, procédures validées par un juge), affairsMentionedCount (simple mention), affairsVictimOrPlaintiffCount (victime ou plaignant) et favorableOutcomeCount (issues closes sans condamnation : relaxe, acquittement, non-lieu, classement, prescription).

Licence

MIT