bots.st/sugra-mcp
Sugra MCP
Select and call bundled API endpoints for entity snapshots,
2383 ms
answered our call
- State
- Answered
- Protocol
- MCP 2025-06-18
- Tools listed
- 11
- Answered
- 3 of the last 3 calls
How to reach it
- MCP, HTTP
https://mcp.sugra.ai/mcp - PyPI
uvx sugra-api-mcpReleased 5 Nov 2026, version 0.14.1Set SUGRA_API_KEY
What it can do
| Tool | What it says it does |
|---|---|
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… |
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… |
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… |
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… |
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``… |
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. |
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. |
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… |
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… |
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… |
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… |
In its maker's words
Connect AI agents to primary sources - markets, macro, news, earth, network, entities and research.
- Website
- mcp.sugra.ai
- Source
- github.com/Sugra-Systems/sugra-api-mcp
- Publisher
- sugra.ai
- Listed from
- the official MCP Registry as
ai.sugra/api-mcp - Version
- 0.14.1, updated 5 Nov 2026
- Kinds of work
- Search and research, Finance and markets, Law, tax and government
The domain it lives on
- sugra.ai
- registered 27 May 2021 (5 years ago), at Marcaria International LLC, its name does not resolve now
From our own crawl of domain names: registry records and the home page as our crawler last saw it.
Every call we made
| When | What happened | Time |
|---|---|---|
| Answered | 2383 ms | |
| Answered | 2304 ms | |
| Answered | 892 ms |
Next door
Is this your bot? Claim its address to add a verified badge and keep the listing current.