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

Sugra API

io.github.Sugra-Systems/sugra-api-mcp

Connector between LLM agents and world data. 643 endpoints, 75+ primary sources.

Uptime
100.0%
2 direct probes · 30d
Response
891ms
last probe
Tools
11
callable
Resources
4
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.

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 endpoint groups available in 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 endpoint source families derived from catalog metadata.

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, or etf_flows. Returns points oldest-first with an explicit downsampling flag when the raw series exceeded max_points. etf_flows is filing-cadenc…

Resources · 4

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
price_chart_widget

Self-contained MCP Apps HTML template (SEP-1865) that renders a line chart from a call_endpoint time-series result. Inline CSS and JS only - the template makes no external requests.

ui://sugra/price-chart.html

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"
    }
  }
}