Sugra API MCP Server

What is Sugra API MCP Server?

The Sugra API MCP Server is the official hosted MCP endpoint of Sugra API, letting AI agents discover and call 1,600+ data endpoints across finance, macro, entity (KYB and sanctions), network, news, earth and research data.

Sugra API aggregates 36 domains from 195 primary sources under one response format. It is aimed at AI agents, fintech apps, research desks and internal dashboards. The hosted Sugra MCP server is published in Anthropic's Connectors Directory and the OpenAI Plugins Directory; a local stdio package, sugra-api-mcp, is also available on PyPI.

How to use Sugra API MCP Server?

You need a Sugra account (the Free plan needs no credit card). Discovery is public, but tool calls require auth: either sign in with OAuth in the browser or send Authorization: Bearer with a Sugra API key. MCP calls draw from the same daily request quota as direct API calls.

The MCP endpoint is https://mcp.sugra.ai/mcp (server name sugra-api).

Claude Code

With OAuth (run /mcp to sign in):

claude mcp add --transport http sugra https://mcp.sugra.ai/mcp

With an API key, as in Sugra's docs:

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

If Claude Code is signed in with a claude.ai account and Sugra is connected from the Connectors Directory, it already appears in /mcp.

Claude Desktop and claude.ai

Add Sugra from the Connectors Directory, or choose Customize → Connectors → Add custom connector, paste the URL and sign in with your Sugra account.

Cursor

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

VS Code

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

For Codex CLI, the docs give codex mcp add sugra --url https://mcp.sugra.ai/mcp --bearer-token-env-var SUGRA_API_KEY.

Key features of Sugra API MCP Server

• Broad coverage: equities, options, crypto, commodities, forex and fundamentals; central banks, statistics agencies and trade; KYB, sanctions, PEP signals and LEI/VAT resolution; IP, ASN, BGP, RPKI and Tor; curated news and GDELT; weather, climate, energy and satellite data; arXiv, NBER and Crossref.
• Catalog-driven tools: the agent searches a bundled catalog locally, then calls an endpoint by operation_id, so one server reaches the whole API.
• Agent hints: endpoint descriptions include duration class, concurrency ceiling and bulk cost, so agents can budget timeouts and parallel calls.
• Composed hosted-only tools: entity resolution, snapshots and timeseries in single calls.
• Compliance-aware screening: sanctions results are returned as a screening signal (clear, review or hit) with a disclaimer, not a compliance determination.
• Same plans for all data: Free ($0, 50 requests/day), Personal ($9/month, 1,000 lookups/day), Dev ($25/month, 5,000/day) and Pro ($59/month, 50,000/day), with no feature gating.

Sugra API MCP Server tools

Our probe returned 11 tools.

• Discovery (read the bundled catalog, no API call): search_endpoints, describe_endpoint, list_toolsets and list_sources. describe_endpoint returns parameters, request_body_schema for JSON-body POSTs and agent_hints.
• Data calls: call_endpoint calls an operation by ID (bulk endpoints bill one request per body item), and fetch_data combines search and call in one round trip for natural-language queries.
• Entity and compliance: sugra_entity_screen screens a person or organization name against the sanctions corpus; sugra_entity_lookup resolves an LEI (via GLEIF) or EU VAT number (via VIES) to a KYB envelope.
• Composed agent tools (hosted only): resolve_entity turns a ticker, company, indicator, coin or currency pair into a canonical entity; get_snapshot runs a named recipe such as company_snapshot or macro_calendar; get_timeseries returns bounded price, macro or ETF-flow series.

Use cases of Sugra API MCP Server

• Market questions: "Show Apple's current quote and a company snapshot, then chart its price over the last year."
• Macro research: "What is the latest US CPI print, and when is the next release on the macro calendar?"
• Counterparty checks: "Screen this supplier name against sanctions lists and look up its LEI record."
• Options analysis: "Pull the VIX term structure and tell me whether it is in contango or backwardation."
• Network intelligence: "Find the ASN and RPKI status for this IP address."

Troubleshooting Sugra API MCP Server

• missing_bearer_token or 401 on a tool call: discovery works without auth, but calls need an OAuth sign-in or Authorization: Bearer with your API key.
• HTTP 429: you exceeded the plan's daily quota; the response carries a Retry-After header. There are no overage charges.
• upstream_timeout: endpoints marked "slow" or "heavy" can be slow on a cold upstream; a single retry often succeeds.
• Duplicate Sugra connections in Claude: if you added a custom connector and then the directory listing, remove the custom one.