Data

Citoyen for AI agents and developers

Citoyen's figures can be read by AI assistants and programs, not only on screen. A public, read-only server gives them the same series as the cards, each with its official producer, period and unit, so an answer can say where a number comes from.

The MCP server

The Model Context Protocol (MCP) is the standard that assistants such as Claude or ChatGPT use to call outside tools. Citoyen's server is free, needs no key or account and only reads: it keeps nothing of the questions asked, it only counts calls to keep the service available.

Server address

https://citoyenapp.com/mcp

Connecting it

  1. In Claude

    On claude.ai or in the desktop app: Settings, Connectors, Add custom connector, then paste the server address.

  2. In other assistants

    ChatGPT in developer mode and the other assistants that accept remote MCP servers: add an HTTP connector with the server address.

  3. In a code editor

    Cursor, VS Code, Claude Code and similar tools: add the server to their MCP configuration, as below.

Configuration for clients that read an MCP file:

{
  "mcpServers": {
    "citoyen": {
      "type": "http",
      "url": "https://citoyenapp.com/mcp"
    }
  }
}

The tools

search
Finds indicators with their codes, the countries named in the question and the related publications.
get_series
The series of one indicator for one country, as charted on its card: values by period, unit, producer and link to the source. Last 10 years by default.
compare_countries
One indicator for 2 to 8 countries from a single harmonised source, so that the values can be compared.
get_ranking
Every covered country ranked on one indicator for the latest period they share, highest value first.
get_publication
The key points of a synthesis note, an analysis or a reform factsheet, with the link to the full text.
get_release_calendar
The next publications of the series: official dates from the producer, or estimated windows.

Limits and rules

  • 60 calls a minute per address. Beyond that, the server asks to retry shortly.
  • Series cover 10 years by default (up to 80 on request, at most 600 points per answer); a comparison covers 2 to 8 countries.
  • Series from private producers, and the military series SIPRI publishes through the World Bank, give only their latest value and the link to the card: their terms do not allow passing on the full series.
  • Publications give their key points and the link, never the full text.
  • Values marked as projected are forecasts, never realised figures.
  • Every answer names its producer: cite it, and link the Citoyen page given with the answer.
  • Calls are counted per day under an anonymous key derived from the IP address, which changes every day; the address itself is never stored, and the counts are kept 30 days.

Other ways in

  • Each indicator page offers its series as CSV: add /data.csv to its address (not for privately produced series).
  • A plain-text map of the site for AI crawlers: /llms.txt
  • Any card can be embedded in another site with its “Embed” button.

Citing

Cite the official producer named with each figure, and Citoyen as the place where it was read, with the link to its page.

Citoyen's selections, checks and texts are protected, and systematic extraction of its database is not allowed. Details: Legal notice