data.gouv.fr

liveGovernmentEurope

France data.gouv.fr open-data catalogue. Keyless read.

6tools
0msauth
free tier50 calls/day

Tools

search_datasets

Search the data.gouv.fr French open-data catalogue for datasets by keyword, organization slug, or tag; returns dataset titles, slugs, and resource counts with pagination.

Parameters
NameTypeDescription
queryoptstring—
organizationoptstring—
tagoptstring—
pageoptnumber—
page_sizeoptnumber—
▶Try it
datasetrequired: id_or_slug

Single dataset by id or slug.

Parameters
NameTypeDescription
id_or_slugreqstring—
▶Try it
resourcesrequired: dataset_id_or_slug

List all downloadable resources (CSV, JSON, XLS, API, etc.) attached to a data.gouv.fr dataset, identified by id or slug; returns file URLs, formats, and last-update dates.

Parameters
NameTypeDescription
dataset_id_or_slugreqstring—
▶Try it
search_organizations

Search data.gouv.fr publishing organizations by name keyword; returns organization names, slugs, and dataset counts — use slugs to filter `search_datasets`.

Parameters
NameTypeDescription
queryoptstring—
pageoptnumber—
page_sizeoptnumber—
▶Try it
organizationrequired: id_or_slug

Single organization by id or slug.

Parameters
NameTypeDescription
id_or_slugreqstring—
▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/datagouv-fr/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/datagouv-fr/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_datasets","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("search_datasets", {});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("france data");