Using Opendatasoft's MCP server

Edited

MCP server functionality is not included directly in your plan. For more information, please contact our support team.

The Model Context Protocol (MCP) is a standard that makes it easier for AI systems and applications to talk to each other. Instead of every tool or model needing its own custom API connection, MCP provides a common language they can all use.

Accordingly, Opendatasoft's MCP server allows generative AI agents to use Opendatasoft APIs and to search our API documentation.

This documentation focuses on configuring Claude Desktop, though you can use the Opendatasoft MCP server with other tools that support it, such as AI-powered code editors like Cursor or Windsurf, or even Microsoft’s agent environment.

Configuring Claude Desktop

The Opendatasoft MCP server is a stand-alone server, hosted by Opendatasoft on its own infrastructure. It guarantees fast and easy access, without needing to worry about server maintenance and upgrades.

Prerequisites

To set up an MCP server on Claude Desktop, the following prerequisites must be met:

  • Claude Desktop is installed on your machine (Windows, macOS or Linux)

  • You have Node.js version 18 or higher

  • You have npm or yarn for package management

You must also have an API key with at least the Browse all datasets permission to be able to use the MCP server.

To define an API key, see Managing API keys.

Locate Claude Desktop configuration file

The Claude Desktop configuration file is used to define and configure MCP servers on your tool.

You'll find the files for the different operating systems—Windows, Mac OS and Linux—at the following locations:

On macOS :

~/Library/Application Support/Claude/claude_desktop_config.json

On Windows :

%APPDATA%\Claude\claude_desktop_config.json

On Linux :

~/.config/Claude/claude_desktop_config.json

MCP server configuration

In the configuration file, it is necessary to add these lines and replace the values indicated below.

{
  "mcpServers": {    
    "opendatasoft": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway@3.4.0",
        "--streamableHttp",
        "https://mcp.opendatasoft.com/mcp",
        "--header",
        "x-domain: <URL OF OPENDATAOSFT MARKETPLACE>",
        "--header",
        "x-apikey: <API KEY>"
      ]
    }
  }
}

It will be necessary to specify the actual values in these lines:

<URL OF OPENDATAOSFT MARKETPLACE>

with the URL of your portal, and

<API KEY>

with the API key you want to use in the MCP server.

Tools available in the MCP server

Tool

Description

Examples of use

get_documentation

Retrieve Explore API documentation.

Get information on Explore API syntax.

get_datasets

List datasets on a given portal using the Explore API.

Search for datasets on your marketplace using either semantic or lexical search.

get_dataset

Retrieve a specific dataset using its identifier.

Get all the metadata of a dataset.

get_dataset

Retrieve records from a specific dataset based on its dataset_id on a given portal using the Explore API.

Get a specific record, generate a specific chart based on the records of the selected dataset.