Sugra API — Claude Code MCP server: what it does, how to install
Connects coding agents to live financial, economic, and maritime figures across 1,600+ endpoints. Useful for sourcing research with timestamps and direct citations.
claude mcp add --transport http api-mcp https://app.sugra.ai/mcpWhat Sugra API does
This server routes agent queries into 36 subject domains supplied by 160+ primary sources, including central banks and national statistics agencies. Instead of hallucinating numbers, the agent pulls verified series for commodities, equities, inflation, or maritime conditions. Each payload returns provenance metadata, timestamped freshness, and quota cost.
Eight core tools handle catalog discovery, entity matching, current snapshots, and historical time series. The catalog itself is bundled directly into the package. Because of this, searching for endpoints happens locally without triggering outbound HTTP calls. Network traffic occurs solely when retrieving actual metrics.
Running locally through stdio requires uvx and an explicit SUGRA_API_KEY environment variable. Without that key, local data requests fail. Alternatively, agents can connect directly to the hosted HTTP endpoint at https://app.sugra.ai/mcp without local package management.
What it helps with
- compile macro tables comparing inflation and central bank interest rates
- pull equity price histories alongside data freshness timestamps
- screen corporate entities against sanctions lists and resolve LEI codes
- collect shipping and weather observations across regional trade lanes
Example prompts for the agent
- Compare G7 inflation figures and central bank policy rates over the past twelve months.
- Fetch the current market snapshot and one-year price history for NVIDIA with source citations.
- Run a sanctions screening check on this supplier and resolve its LEI identity.
How to install Sugra API
1Platform CLI: remote server
claude mcp add --transport http api-mcp https://app.sugra.ai/mcp2Platform CLI
claude mcp add --env SUGRA_API_KEY=<SUGRA_API_KEY> --transport stdio sugra-api -- uvx sugra-api-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from sugra-api-mcp <command>
1Platform CLI: remote server
codex mcp add sugra-api --url https://app.sugra.ai/mcp2Platform CLI
codex mcp add sugra-api --env SUGRA_API_KEY=<SUGRA_API_KEY> -- uvx sugra-api-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from sugra-api-mcp <command>
Config file
{
"mcpServers": {
"sugra-api": {
"url": "https://app.sugra.ai/mcp"
}
}
}{
"mcpServers": {
"sugra-api": {
"command": "uvx",
"args": [
"sugra-api-mcp"
],
"env": {
"SUGRA_API_KEY": "<SUGRA_API_KEY>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from sugra-api-mcp <command>
Config file
{
"servers": {
"sugra-api": {
"type": "http",
"url": "https://app.sugra.ai/mcp"
}
}
}{
"servers": {
"sugra-api": {
"type": "stdio",
"command": "uvx",
"args": [
"sugra-api-mcp"
],
"env": {
"SUGRA_API_KEY": "<SUGRA_API_KEY>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from sugra-api-mcp <command>
1Platform CLI: remote server
gemini mcp add -t http sugra-api https://app.sugra.ai/mcp2Platform CLI
gemini mcp add -e SUGRA_API_KEY=<SUGRA_API_KEY> sugra-api uvx sugra-api-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from sugra-api-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Sugra API
How to install Sugra API in Claude Code?
Run claude mcp add --transport http sugra-api https://app.sugra.ai/mcp in your terminal. For local stdio execution, run claude mcp add --env SUGRA_API_KEY=<SUGRA_API_KEY> --transport stdio sugra-api -- uvx sugra-api-mcp.
What does Sugra API do?
It provides an interface to over 1,600 data endpoints spanning economic, market, maritime, and regulatory feeds. Every returned record includes origin attribution and data freshness markers.
Does searching the endpoint catalog consume API requests?
No, the catalog comes packaged inside the server. Entity lookup and endpoint discovery run locally, so only requests for raw metric values hit the external network.
