Sugra MCP

Sugra MCP

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

Website · Documentation · Videos · Blog · Free API key

Sugra MCP is built and run by Sugra Systems, Inc. It brings Sugra Data into AI assistants and agents over the Model Context Protocol: 1,600+ endpoints from 200 primary sources across 36 data domains - central banks, national statistics offices, regulators, intergovernmental bodies and more. The agent searches the catalog, reads an endpoint's description and calls it, and every answer carries its source and date.

Published in Anthropic's Connectors Directory, the OpenAI Plugins Directory and the GitHub MCP Registry. Works with Claude, Claude Code, ChatGPT, Codex, Grok, Cursor, Antigravity, GitHub Copilot, VS Code, Zed, Cline, Continue and any MCP client.

Watch: How Sugra MCP works · Seven directions, one key

Seven directions

Install

The server is hosted, so there is nothing to run. Add Sugra from your agent's directory or install the sugra-api-skills plugin, then connect as shown below. The plugin also carries the Sugra API Skills, which give the agent the procedure - find an operation, read the response, cite the source.

Anthropic - Claude and Claude Code

Claude (claude.ai, Desktop, mobile and Cowork): Add to Claude opens Sugra in Anthropic's Connectors Directory.

Claude Code, the plugin with the skills and the server:

/plugin marketplace add Sugra-Systems/sugra-api-plugins

/plugin install sugra-api-skills@sugra-api-plugins

OpenAI - ChatGPT and Codex

Add to ChatGPT opens Sugra in the OpenAI Plugins Directory, which serves both ChatGPT and Codex. In ChatGPT the skills install together with the server.

Codex, the skills plugin:

codex plugin marketplace add Sugra-Systems/sugra-api-plugins

codex plugin add sugra-api-skills@sugra-api-plugins

GitHub - Copilot and VS Code

GitHub MCP Registry opens Sugra in GitHub's registry. Its Install MCP server button adds the server to VS Code, VS Code Insiders or the GitHub Copilot app.

GitHub Copilot CLI, the plugin with the skills and the server:

copilot plugin marketplace add Sugra-Systems/sugra-api-plugins

copilot plugin install sugra-api-skills@sugra-api-plugins

VS Code: Install in VS Code adds the server.

xAI - Grok and Cursor

Grok, the plugin with the skills and the server:

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

Cursor: Install in Cursor adds the server. The plugin with the skills and the server:

git clone https://github.com/Sugra-Systems/sugra-api-plugins

mkdir -p ~/.cursor/plugins/local cp -R sugra-api-plugins/cursor ~/.cursor/plugins/local/sugra-api-skills

Antigravity

The skills plugin:

git clone https://github.com/Sugra-Systems/sugra-api-plugins

agy plugin install ./sugra-api-plugins/antigravity

Antigravity does not start the server from the plugin: add it as shown under Connect.

Other agents

The skills, for any agent that reads Agent Skills:

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

The server: add it as shown under Connect.

Run it locally

The PyPI package runs the server on your machine over stdio with an API key. Python 3.13 or newer:

pip install sugra-api-mcp

export SUGRA_API_KEY=sugra_... # free key: https://app.sugra.ai/register sugra-api-mcp call quotes_symbol_price --params '{"symbol":"AAPL"}'

Connect

Every client connects to one address. Sign in with your Sugra account, or send an API key as Authorization: Bearer :

https://mcp.sugra.ai/mcp

Anthropic - Claude and Claude Code

Claude: connect Sugra in the directory and sign in with your Sugra account. Added Sugra earlier as a custom connector? Remove that one before you connect from the directory, or you will have two.

Claude Code signed in with a claude.ai account picks the connector up on its own. With the plugin, sign in to its server from /mcp.

OpenAI - ChatGPT and Codex

In ChatGPT or Codex, connect Sugra and sign in with your Sugra account.

GitHub - Copilot and VS Code

GitHub Copilot CLI, by hand:

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

VS Code, by hand, .vscode/mcp.json:

{ "servers": { "sugra": { "type": "http", "url": "https://mcp.sugra.ai/mcp" } } }

Both open the Sugra sign-in page in your browser the first time they connect.

xAI - Grok and Cursor

Grok connects through the plugin.

Cursor, by hand, ~/.cursor/mcp.json:

{ "mcpServers": { "sugra": { "url": "https://mcp.sugra.ai/mcp" } } }

To sign in, open Cursor Settings, then Tools & MCPs, and select Connect next to sugra.

Antigravity

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

The CLI, the app and the IDE share the server. Antigravity opens the Sugra sign-in page the first time the agent uses it.

Other agents

Add the address above as a remote MCP server in any client that speaks Streamable HTTP.

Local package - Claude Desktop, Cursor and other stdio clients

{

"mcpServers": { "sugra": { "command": "sugra-api-mcp", "env": { "SUGRA_API_KEY": "sugra_..." } } } }

Claude Desktop reads it from claude_desktop_config.json, Cursor from ~/.cursor/mcp.json. Other stdio clients take the same command and environment variable in their own MCP settings.

Tools

The server also ships six workflow prompts (market snapshot, macro briefing, sanctions screening, sector comparison, earth conditions, source overview) and serves five of the Sugra API Skills as MCP resources under sugra://skills/.

Documentation

• Sugra MCP
• Quickstart
• Rate limits and errors
• [Plans and billing](https://do