sugra.ai
Get API key

Sugra MCP

Connect AI agents to primary sources - markets, macro, news, earth, network, entities and research.

The connector between AI assistants and Sugra Data: 1,600+ endpoints from 200 primary sources across 36 data domains, served over the Model Context Protocol.

Get API key GitHub

Primary sources

Central banks, national statistics offices, regulators, intergovernmental bodies and more.

Search, read, call

The agent searches the catalog, reads an endpoint's description and calls it.

Source and date

Every answer carries its source and date.

Published in Anthropic's Connectors Directory, the OpenAI Plugins Directory and the GitHub MCP Registry.

Connect your client

The Sugra MCP server is listed in Anthropic's Connectors Directory.

Add to Claude

The Sugra MCP server is listed in OpenAI's Plugins Directory for ChatGPT and Codex.

Add to ChatGPT

Skills (optional)

Sugra API Skills are listed in OpenAI's Plugins Directory too.

The skills teach the agent how to find, call and cite Sugra endpoints.

Signed in to Claude Code with a claude.ai account? Add the Sugra MCP server in Claude and it appears in /mcp on its own. Otherwise, add it with your API key.

Server

bash / zsh
claude mcp add --transport http sugra https://mcp.sugra.ai/mcp --header "Authorization: Bearer $SUGRA_API_KEY"
PowerShell
claude mcp add --transport http sugra https://mcp.sugra.ai/mcp --header "Authorization: Bearer $env:SUGRA_API_KEY"

Your shell fills in the API key from the SUGRA_API_KEY environment variable when you run the command. In cmd.exe, write %SUGRA_API_KEY%. No key yet? Get API key

Skills (optional)

Terminal
claude plugin marketplace add Sugra-Systems/sugra-api-plugins
claude plugin install sugra-api-skills@sugra-api-plugins

The skills teach the agent how to find, call and cite Sugra endpoints.

In the Codex app, install the Sugra MCP server from OpenAI's Plugins Directory. In the Codex CLI, add it with your API key.

Server

Terminal
codex mcp add sugra --url https://mcp.sugra.ai/mcp --bearer-token-env-var SUGRA_API_KEY

Reads your API key from the SUGRA_API_KEY environment variable. No key yet? Get API key

Skills (optional)

In the Codex app, install Sugra API Skills from OpenAI's Plugins Directory. In the Codex CLI, add them from GitHub.

Terminal
codex plugin marketplace add Sugra-Systems/sugra-api-plugins
codex plugin add sugra-api-skills@sugra-api-plugins

The skills teach the agent how to find, call and cite Sugra endpoints.

Server

bash / zsh
grok mcp add --transport http sugra https://mcp.sugra.ai/mcp --header "Authorization: Bearer $SUGRA_API_KEY"
PowerShell
grok mcp add --transport http sugra https://mcp.sugra.ai/mcp --header "Authorization: Bearer $env:SUGRA_API_KEY"

Your shell fills in the API key from the SUGRA_API_KEY environment variable when you run the command. In cmd.exe, write %SUGRA_API_KEY%. No key yet? Get API key

Skills (optional)

Terminal
grok plugin install Sugra-Systems/sugra-api-plugins#xai

The skills teach the agent how to find, call and cite Sugra endpoints.

Server

Terminal
agy mcp add sugra-api https://mcp.sugra.ai/mcp

Antigravity opens the Sugra sign-in page in your browser the first time the agent uses the server.

Skills (optional)

Terminal
git clone https://github.com/Sugra-Systems/sugra-api-plugins
agy plugin install ./sugra-api-plugins/antigravity

The skills teach the agent how to find, call and cite Sugra endpoints.

The plugin declares the same server, but Antigravity CLI 1.4.9 does not start a server that a plugin declares yet, so add it with the command above.

The Sugra MCP server is listed in the GitHub MCP Registry. In Copilot CLI, add it with the command below.

Server

Terminal
copilot mcp add --transport http sugra-api https://mcp.sugra.ai/mcp

Copilot CLI opens the Sugra sign-in page in your browser the first time it connects to the server.

Skills (optional)

Terminal
copilot plugin marketplace add Sugra-Systems/sugra-api-plugins
copilot plugin install sugra-api-skills@sugra-api-plugins

The skills teach the agent how to find, call and cite Sugra endpoints.

The plugin adds the same server, so with the plugin installed you can skip the server command.

Add to Cursor

Reads your API key from the SUGRA_API_KEY environment variable. No key yet? Get API key

Or add to ~/.cursor/mcp.json

JSON
{
  "mcpServers": {
    "sugra": {
      "url": "https://mcp.sugra.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SUGRA_API_KEY}"
      }
    }
  }
}

Skills (optional)

Terminal
npx skills add https://mcp.sugra.ai

The skills teach the agent how to find, call and cite Sugra endpoints.

The Sugra MCP server is listed in the GitHub MCP Registry, whose Install in VS Code button adds it. Or add it by hand.

Add to .vscode/mcp.json

JSON
{
  "inputs": [
    {
      "type": "promptString",
      "id": "sugra-api-key",
      "description": "Sugra API key",
      "password": true
    }
  ],
  "servers": {
    "sugra": {
      "type": "http",
      "url": "https://mcp.sugra.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${input:sugra-api-key}"
      }
    }
  }
}

VS Code asks for the key when the server starts.

Skills (optional)

Terminal
npx skills add https://mcp.sugra.ai

The skills teach the agent how to find, call and cite Sugra endpoints.

Any MCP client that supports remote servers.

URL

URL
https://mcp.sugra.ai/mcp

Send the key in the Authorization header as Bearer followed by the key, from wherever your client keeps secrets. No key yet? Get API key

Skills (optional)

Terminal
npx skills add https://mcp.sugra.ai

The skills teach the agent how to find, call and cite Sugra endpoints.

GitHub PyPI Docs