{"id":"ai.sugra/api-mcp","slug":"ai-sugra-api-mcp","title":"Sugra MCP","description":"Connect AI agents to primary sources - markets, macro, news, earth, network, entities and research.","version":"0.14.1","publisher":{"kind":"domain","id":"sugra.ai","label":"sugra.ai","url":"https://sugra.ai"},"website":"https://mcp.sugra.ai","repository":"https://github.com/Sugra-Systems/sugra-api-mcp","remotes":[{"type":"streamable-http","url":"https://mcp.sugra.ai/mcp"}],"packages":[{"registryType":"pypi","identifier":"sugra-api-mcp","version":"0.14.1","transport":{"type":"stdio"},"environmentVariables":[{"description":"Your Sugra API key (sugra_...). Required for data tools; catalog tools work without it. Free key: https://app.sugra.ai/register (50 req/day). Only env var needed for local installs and directory sandboxes.","isRequired":true,"format":"string","isSecret":true,"name":"SUGRA_API_KEY"}]}],"published":"2026-11-05","updated":"2026-11-05","status":"online","auth":"","latency_ms":923,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"sugra_entity_screen","title":"Sugra Entity screen","description":"Screen a person or organization name against the Sugra sanctions corpus.\n\nReturns a SCREENING SIGNAL, not a compliance determination. Sugra is a\ntechnology provider, not a sanctions authority or consumer reporting agency.\nPEP and adverse-media coverage is supplementary and non-comprehensive - a\n`clear` result is not proof of absence, and a `hit` is a candidate match to\nreview, not a finding.\n\nOutp","read_only":true},{"name":"sugra_entity_lookup","title":"Sugra Entity lookup","description":"Resolve an entity by identifier and return its composed KYB envelope.\n\n`anchor` is `lei` (Legal Entity Identifier, resolved via the GLEIF registry)\nor `vat` (EU VAT number, validated via the EU VIES service). The result\nweaves identity, a sanctions screening signal, and - on request - ownership\nand adverse-media slices.\n\nThe screening verdict is a SCREENING SIGNAL, not a compliance determination,\n","read_only":true},{"name":"search_endpoints","title":"Search endpoints","description":"Search the bundled Sugra endpoint catalog by natural-language query.\n\nUse this to pick an operation_id. It does not fetch data. Typical loop:\n1. search_endpoints(query) -> ranked hits with required_parameters\n2. describe_endpoint(operation_id) -> params, request_body_schema, agent_hints\n3. call_endpoint(operation_id, params=..., body=...) or fetch_data(query, params=...)\n\nFilter with toolset or so","read_only":true},{"name":"describe_endpoint","title":"Describe endpoint","description":"Describe one Sugra API endpoint by operation_id.\n\nIncludes agent_hints (duration_class fast/slow/heavy, max_concurrency,\nbulk billing) so you can budget timeouts and parallelism before calling.\nPOST endpoints with a JSON body also carry request_body_schema (the\nresolved JSON schema) - construct the `body` argument from it instead\nof guessing key names. Call this after search_endpoints and before\nc","read_only":true},{"name":"call_endpoint","title":"Call endpoint","description":"Call a Sugra API endpoint by operation_id from the bundled catalog.\n\nPlan calls with describe_endpoint's agent_hints: duration_class \"fast\"\nusually responds in under ~2s, \"slow\" usually 1-5s and occasionally 15s+\non a cold upstream, \"heavy\" can exceed the gateway timeout - keep parallel\ncalls within max_concurrency and prefer small batches. Bulk endpoints bill\n1 request credit per body item. Failu","read_only":true},{"name":"list_toolsets","title":"List toolsets","description":"List catalog groups with endpoint counts and short descriptions.\n\nUse the group names as the toolset filter on search_endpoints. This\ndoes not call the Sugra API; it reads the bundled catalog.\n","read_only":true},{"name":"fetch_data","title":"Fetch data","description":"One-step fetch: find the best Sugra endpoint for the query and call it.\n\nCombines search_endpoints + call_endpoint into a single round trip. Use\nthis when you want data without manually picking an operation_id. The\nfull search_endpoints + describe_endpoint + call_endpoint dance is still\navailable when you need explicit control, but for most natural-language\nqueries this tool is enough.\n\nBehavior:\n","read_only":true},{"name":"list_sources","title":"List sources","description":"List source families in the bundled catalog with endpoint counts.\n\nUse the family names as the source filter on search_endpoints. This\ndoes not call the Sugra API.\n","read_only":true},{"name":"resolve_entity","title":"Resolve entity","description":"Resolve free text to a canonical market or macro entity.\n\nTurns a ticker, company name, macro indicator, coin, or currency pair into\nthe agent plane's ``{namespace, ids}`` entity for use with get_snapshot and\nget_timeseries. A cross-namespace collision (e.g. a ticker that is both an\nequity and a coin) returns status \"ambiguous\" with ranked candidates and\nNEVER silently picks one; pass type_hint (e","read_only":true},{"name":"get_snapshot","title":"Get snapshot","description":"Composed current view of an entity via a named recipe.\n\nExecutes a fixed server-side recipe (company_snapshot, etf_snapshot,\nquote_snapshot, macro_indicator_snapshot, macro_calendar,\nearnings_snapshot, debt_snapshot) and returns one envelope with freshness,\nprovenance, per-component coverage, and billing. Composed calls charge the\nrecipe's fixed cost (1-2 units) from the daily quota. status \"parti","read_only":true},{"name":"get_timeseries","title":"Get timeseries","description":"Bounded timeseries for an entity: price, macro_series, etf_flows or\netf_monthly_flows.\n\nReturns points oldest-first with an explicit downsampling flag when the\nraw series exceeded max_points. Times are UTC. Costs 1 unit per call.\n\nRead the step from ``served_granularity``, not ``granularity``. The\nlatter echoes the request; the former is the step the source built the\npoints at, and the two can dif","read_only":true}],"server_info":{"name":"sugra-api","version":"0.14.1","websiteUrl":"https://sugra.ai","icons":[{"src":"https://app.sugra.ai/images/brand/sugra-app-icon-192.png","mimeType":"image/png","sizes":["192x192"]},{"src":"https://app.sugra.ai/images/brand/sugra-app-icon-512.png","mimeType":"image/png","sizes":["512x512"]}]},"category":"news","tags":["research","web-search","agents"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-06-22","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/ai-sugra-api-mcp/"}