Sugra API MCP Server

Works with ChatGPT, Claude, Gemini, xAI, Cursor, VS Code and any MCP client.

Local + remotestreamable-httpstdio

What is the Sugra API MCP Server?

Sugra API MCP is an MCP project maintained in the sugra-systems/sugra-api-mcp repository. The maintainer describes its purpose as “Works with ChatGPT, Claude, Gemini, xAI, Cursor, VS Code and any MCP client”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using sugra-api-mcp. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares SUGRA_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
duration_classfast (under ~2s, snapshot-backed), slow (live upstream proxying, occasionally 15s+), or heavy (per-item upstream work, large batches can exceed the gateway…
max_concurrencyadvisory ceiling for parallel calls from one session
bulk_coston per-item bulk endpoints: 1 request credit per item in the request body (the API reports the total in the X-RateLimit-Cost response header)
fetch_dataOne-step: find best endpoint for a natural-language query and call it. Combines search + call in one round trip.
search_endpointsSearch the bundled endpoint catalog. Runtime search does not fetch /openapi.json.
describe_endpointInspect an endpoint by operation_id, including path, method, parameters, required inputs, agent_hints, and request_body_schema for JSON-body POST operations.
call_endpointCall a Sugra API operation by operation_id. Arbitrary path calls are no longer supported.
list_toolsetsList catalog groups with endpoint counts and descriptions.
list_sourcesShow bundled catalog source metadata.
sugra_entity_screenScreen a name against sanctions and watchlists (Sugra Entity).
sugra_entity_lookupComposed entity lookup by identifier - anchor is lei or vat, plus the identifier value; returns registry identity + screening (Sugra Entity).
resolve_entityFree text (ticker, company, indicator, coin, currency pair) to a canonical market or macro entity. Ambiguous matches return ranked candidates, never a silent…
get_snapshotEntity plus a named recipe to one composed current view with freshness, provenance, coverage, and billing blocks. Composed calls charge a fixed recipe cost…
get_timeseriesEntity plus metric (price, macro_series, etf_flows, etf_monthly_flows) to a bounded series with an explicit downsampling flag. etf_flows estimates at filing…

How to install the Sugra API MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
SUGRA_API_KEYDeclared in the maintainer’s client configuration.Optional