Use OpenData with AI

Connect OpenData to your AI assistant so you can search, query, and visualize datasets in plain English, without leaving the conversation.

Ask “chart US inflation adjusted for wage growth over the last 20 years” and your assistant finds the right dataset, runs the query, and renders an interactive chart. You can also pull the raw data as CSV or JSON if you want to dig in further.

We measured what that changes: thirty questions written to need a data catalog, one model, answered with this connector attached and with web search alone. See the run.

Connect it

One button. Claude is the default because it's the fastest path; the arrow next to it covers ChatGPT, Cursor, VS Code, Claude Code, Antigravity, and Windsurf. Most tools sign you in with your OpenData account, so there's no config file and no API key to paste.

Using something else? Pick your tool.

Claude opens with the details filled in. Check the URL, click Add, then sign in with your OpenData account.

Don't have an OpenData account? Create one free. It only takes a minute and no credit card is required.

First, what's MCP?

MCP stands for Model Context Protocol. Think of it as a way for AI assistants like Claude to safely connect to outside services. We run an MCP “server” on our end. When you point your AI assistant at it, the assistant gains the ability to search OpenData, run queries, and pull rows, right inside the chat.

You don't need to know how any of this works under the hood. The button above hands your assistant the one thing it needs, which is this address:

https://mcp.tryopendata.ai/mcp

Setting it up by hand

The one-click links open your tool with the server details filled in. If a link doesn't open anything, or you'd rather see what it's doing, here are the same steps done manually.

Claude (web or desktop)
  1. 1
    Open Claude Desktop or go to claude.ai/customize/connectors in your browser
  2. 2
    Click the + button, then select Add custom connector
  3. 3
    Fill in the form:
    • Name: OpenData
    • Server URL:
      https://mcp.tryopendata.ai/mcp
  4. 4
    Click Add. Claude will open a sign-in page. Log in with your OpenData account to authorize the connection.
  5. 5
    Open a new conversation and try: “Use OpenData to chart real wages vs. inflation since 2000”
Claude Code

Run this once. --scope user makes it available in every project rather than only the folder you ran it in. Then type /mcp inside a session to sign in.

claude mcp add --transport http --scope user opendata https://mcp.tryopendata.ai/mcp
Antigravity (App, IDE & agy CLI)

Connect Antigravity with an API key (our OAuth metadata proxy filters scopes for ChatGPT, which strict RFC 8414 clients like Antigravity reject during OAuth discovery). Antigravity App renders OpenData's interactive charts and tables inline via MCP Apps, while agy CLI runs the same tools with plain-text output.

  1. 1
    Fastest (CLI): run this once, replacing YOUR_API_KEY with a key from Settings > API Keys. Keep --header before opendata (agy mcp add rejects flags placed after the server name); https:// auto-detects Streamable HTTP:
    agy mcp add --header "Authorization: Bearer YOUR_API_KEY" opendata https://mcp.tryopendata.ai/mcp
  2. 2
    Or edit the config file shared by Antigravity App, IDE, and CLI: global ~/.gemini/config/mcp_config.json or workspace-only .agents/mcp_config.json:
    {
    "mcpServers": {
    "opendata": {
    "serverUrl": "https://mcp.tryopendata.ai/mcp",
    "headers": {
    "Authorization": "Bearer YOUR_API_KEY"
    }
    }
    }
    }
  3. 3
    Type /mcp inside agy (or open Customizations > Installed > MCP Servers in Antigravity App) to check connection status, reload after edits, or view logs.
Cursor
  1. 1
    Open Cursor Settings > MCP > Add new MCP server
  2. 2
    Choose HTTP, then paste the server URL:
    https://mcp.tryopendata.ai/mcp
  3. 3
    Cursor signs in through your browser the first time it connects. If it asks for an Authorization header instead, enter Bearer YOUR_API_KEY with a key from Settings > API Keys.
VS Code (Copilot)

The Command Palette is VS Code's built-in search bar for actions.

  1. 1
    Open the Command Palette (Cmd+Shift+P on Mac, Ctrl+Shift+P on Windows)
  2. 2
    Type MCP: Add Server and select it
  3. 3
    Choose HTTP, paste the server URL:
    https://mcp.tryopendata.ai/mcp
  4. 4
    Name it opendata. VS Code opens a browser window to sign in the first time it connects.
Windsurf

Windsurf is the most hands-on of these. Instead of a settings UI, you edit a small text file that Windsurf reads when it starts up.

  1. 1
    Open your Windsurf config file at this path (create it if it doesn't exist):
    ~/.codeium/windsurf/mcp_config.json
  2. 2
    Add the block below, replacing YOUR_API_KEY with a key from Settings > API Keys:
{
"mcpServers": {
"opendata": {
"serverUrl": "https://mcp.tryopendata.ai/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
  1. 3
    Save the file and restart Windsurf. OpenData tools will appear in Cascade, which is Windsurf's chat panel.
Any other AI assistant

If your AI tool supports remote MCP servers, it can connect to OpenData. Look for a setting to add a custom server, paste in the URL below, and choose HTTP (sometimes labelled Streamable HTTP). Pick OAuth if it offers it; if it only supports headers, set Authorization to Bearer YOUR_API_KEY (or X-API-Key to YOUR_API_KEY).

https://mcp.tryopendata.ai/mcp

About API keys

Most clients sign you in the way a website does: you click through a sign-in page once and the tool remembers you. A few older tools can't do that and want an API key instead, which is a long random string that works like a password just for software. It's free to create:

  1. Go to Settings > API Keys and click Create API Key.
  2. Name it something memorable like “Cursor” or “VS Code”.
  3. Copy the key. It starts with od_live_. You'll only see it once, so paste it somewhere safe.

Wherever you see YOUR_API_KEY above, that's where the key goes.

See it in action

Here's what a typical conversation looks like. The assistant searches for datasets, runs SQL, and renders charts inline.

mcp · tryopendata.aiCONNECTED · 7 TOOLS

Simulated MCP conversation.

What Can You Ask?

Use natural language to describe what you want. The assistant figures out which dataset to use and what query to run. You can ask follow-up questions, request a different chart type, or export the underlying data at any point.

Start simple, then build up. Some examples to try:

Try askingWhat happens
“What datasets do you have about climate?”Searches the catalog and lists matches with descriptions
“Show me the first 10 rows of fred/unemployment”Pulls a preview so you can see the shape of the data
“Chart real wages vs. inflation since 2000”Finds FRED data, adjusts for CPI, builds an interactive chart
“Show me housing price trends by state”Searches datasets and returns a filterable table
“Compare US vs. EU unemployment over the last decade”Finds both series and charts them side by side
“What's the relationship between CO2 and GDP?”Pulls emissions and economic data, builds a scatter plot
“Export the top 50 cities by population as CSV”Queries census data and gives you a download link

Results show up as charts, tables, and export links inside your conversation. If you want the source data, just ask for a CSV or JSON export.

Troubleshooting

The install link didn't open anything

The Cursor and VS Code links hand off to a desktop app, so they only work on a machine where that app is installed, and some browsers ask for permission before handing off. If nothing happens, use the manual steps above instead.

OpenData tools don't show up

Start a fresh conversation after adding the connection. Most apps need a new session to pick up new tools. If you used the config file method in Claude Desktop, make sure you restarted the app after saving.

I get an “unauthorized” error

This means your AI tool tried to talk to OpenData but couldn't prove who it was. If your tool signs in through a browser, disconnect and reconnect the server to redo the sign-in. If it uses an API key, check that Authorization reads Bearer od_live_... (or X-API-Key reads od_live_...) using a real key from Settings > API Keys. A wrong key is worse than none: some clients report a hard connection failure instead of falling back to sign-in, so remove the headers block entirely if you want the browser OAuth flow.

My tool isn't listed here

If your AI assistant supports remote MCP servers, it should work. Use https://mcp.tryopendata.ai/mcp as the server URL. Still stuck? Open an issue on GitHub and we'll help.

Next Steps

Search datasets

Search for datasets or run quick actions