Using Opendatasoft's MCP server
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 |
| Retrieve Explore API documentation. | Get information on Explore API syntax. |
| List datasets on a given portal using the Explore API. | Search for datasets on your marketplace using either semantic or lexical search. |
| Retrieve a specific dataset using its identifier. | Get all the metadata of a 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. |