Skip to content
Back to search
100
MCP live v0.9.1 MCP 2025-11-25 streamable-http

Sugra API

ai.sugra/api-mcp

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

Uptime
100.0%
5 direct probes · 30d
Response
846ms
last probe
Tools
11
callable
Resources
8
readable
Prompts
6
available

Tools · 11

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 consu…

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 s…

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_pa…

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 e…

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 occas…

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 ope…

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_snap…

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…

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 ar…

Resources · 8

catalog_domains

Endpoint groups (toolsets) in the bundled Sugra catalog: name, description, and endpoint count per group. Same data as the list_toolsets tool.

sugra://catalog/domains
catalog_sources

Source families in the bundled Sugra catalog with endpoint counts per family. Same data as the list_sources tool.

sugra://catalog/sources
attribution

How Sugra names data sources, where per-call attribution metadata appears, and where the full source list is published.

sugra://attribution
skill_explore_catalog

Find and call the right Sugra API endpoint through the bundled catalog (search, describe, call).

sugra://skills/explore-catalog
skill_envelope_attribution

Parse Sugra API payloads, keep source attribution, and tell observation time from request time.

sugra://skills/envelope-attribution
skill_auth_limits

Authenticate to Sugra API MCP and stay inside the daily request quota.

sugra://skills/auth-limits
skill_hosted_vs_gateway

Choose hosted Sugra MCP versus the local gateway package, and which tools exist on each.

sugra://skills/hosted-vs-gateway
skill_cross_domain_briefing

Compose one briefing from two or three Sugra domains using only the eight gateway tools.

sugra://skills/cross-domain-briefing

Prompts · 6

market_snapshot

Build a sourced price and profile snapshot for one ticker symbol.

macro_briefing

Brief the key macro indicators for a country from sovereign sources.

sanctions_screening

Screen a name against the sanctions corpus and report the signal.

sector_compare

Compare two sectors through ETF and valuation endpoints.

earth_conditions

Report weather, air quality, and nearby hazards for a coordinate.

source_overview

Explain what the catalog offers for a data domain, sources included.

How to use

Add to your Claude Desktop / Cursor / Cline MCP config:

{
  "mcpServers": {
    "sugra_api": {
      "url": "https://app.sugra.ai/mcp",
      "transport": "streamable-http"
    }
  }
}