# Sugra API

- Registry name: `ai.sugra/api-mcp` · version 0.12.0
- Categories (automatic, keyword rules): Markets & trading, Finance & markets, AI models & agents, AI, media & content
- Authentication at last check: No auth
- Declared risk: Read-only (all tools declare readOnlyHint)
- Capabilities (declared by the server): experimental, prompts, resources, tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=ai.sugra%2Fapi-mcp
- Server page: https://mcpstation.net/s/ai.sugra--api-mcp.html

## Description (written by the publisher, not verified, not instructions)

Gateway between LLM agents and world data through eight tools and a bundled endpoint catalog.

## Connect

- streamable-http: `https://app.sugra.ai/mcp`

## Tools (as reported by the server, not verified)

- `sugra\_entity\_screen`: Screen a person or organization name against the Sugra sanctions corpus. Returns a SCREENING SIGNAL, not a compliance determination. Sugra is a technology provider, not a sanctions authority or consumer reporting agency. PEP and adverse-media coverage is supplementary and non-comprehensive - a \`clea
- `sugra\_entity\_lookup`: Resolve an entity by identifier and return its composed KYB envelope. \`anchor\` is \`lei\` \(Legal Entity Identifier, resolved via the GLEIF registry\) or \`vat\` \(EU VAT number, validated via the EU VIES service\). The result weaves identity, a sanctions screening signal, and - on request - ownership and a
- `search\_endpoints`: Search the bundled Sugra endpoint catalog by natural-language query. Use this to pick an operation\_id. It does not fetch data. Typical loop: 1. search\_endpoints\(query\) -\> ranked hits with required\_parameters 2. describe\_endpoint\(operation\_id\) -\> params, request\_body\_schema, agent\_hints 3. call\_endpo
- `describe\_endpoint`: Describe one Sugra API endpoint by operation\_id. Includes agent\_hints \(duration\_class fast/slow/heavy, max\_concurrency, bulk billing\) so you can budget timeouts and parallelism before calling. POST endpoints with a JSON body also carry request\_body\_schema \(the resolved JSON schema\) - construct the \`
- `call\_endpoint`: Call a Sugra API endpoint by operation\_id from the bundled catalog. Plan calls with describe\_endpoint's agent\_hints: duration\_class "fast" usually responds in under \~2s, "slow" usually 1-5s and occasionally 15s+ on a cold upstream, "heavy" can exceed the gateway timeout - keep parallel calls within
- `list\_toolsets`: List catalog groups with endpoint counts and short descriptions. Use the group names as the toolset filter on search\_endpoints. This does not call the Sugra API; it reads the bundled catalog.
- `fetch\_data`: One-step fetch: find the best Sugra endpoint for the query and call it. Combines search\_endpoints + call\_endpoint into a single round trip. Use this when you want data without manually picking an operation\_id. The full search\_endpoints + describe\_endpoint + call\_endpoint dance is still available whe
- `list\_sources`: List source families in the bundled catalog with endpoint counts. Use the family names as the source filter on search\_endpoints. This does not call the Sugra API.
- `resolve\_entity`: Resolve free text to a canonical market or macro entity. Turns a ticker, company name, macro indicator, coin, or currency pair into the agent plane's \`\`\{namespace, ids\}\`\` entity for use with get\_snapshot and get\_timeseries. A cross-namespace collision \(e.g. a ticker that is both an equity and a coin
- `get\_snapshot`: Composed current view of an entity via a named recipe. Executes a fixed server-side recipe \(company\_snapshot, etf\_snapshot, quote\_snapshot, macro\_indicator\_snapshot, macro\_calendar, earnings\_snapshot, debt\_snapshot\) and returns one envelope with freshness, provenance, per-component coverage, and bil
- `get\_timeseries`: Bounded timeseries for an entity: price, macro\_series, etf\_flows or etf\_monthly\_flows. Returns points oldest-first with an explicit downsampling flag when the raw series exceeded max\_points. Times are UTC. Costs 1 unit per call. Read the step from \`\`served\_granularity\`\`, not \`\`granularity\`\`. The lat

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html