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%
5 direct probes · 30d
Response
763ms
last probe
Tools
11
callable
Resources
8
readable
Prompts
6
available
Primary URL
https://app.sugra.ai/mcp
Score: 100/100
Handshake verified by our own probe.
why this score
pass Answers the MCP handshake 50/50
The handshake and the list calls succeeded on the primary URL.
pass Lists tools, resources or prompts 30/30
11 tools, 8 resources, 6 prompts returned.
pass 3 or more catalogue items 10/10
25 items in total; 3 or more earns these points.
pass Describes itself 10/10
80 characters; more than 30 earns these points.

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 the right Sugra operation, call it over HTTPS or MCP, and check that the result answers the question. Use when the path or operation_id is unknown, before guessing parameters, before quoting a fi…

sugra://skills/explore-catalog
skill_envelope_attribution

Parse Sugra API payloads over HTTPS or MCP, keep source attribution, and tell observation time from request time. Use when reading a response, citing a figure, or shaping a large payload.

sugra://skills/envelope-attribution
skill_auth_limits

Authenticate to Sugra over HTTPS and MCP, stay inside the daily quota, and act on each error. Use when setting up a client, before a bulk call, or when a call returns 400, 401, 404, 422, 429, 5xx, mis…

sugra://skills/auth-limits
skill_hosted_vs_gateway

Attach a client to Sugra over HTTPS or MCP and install these skills. Use when setting up Claude (claude.ai, Desktop, Code), ChatGPT, Codex, Cursor, VS Code, Gemini CLI, Grok, OpenBB, a custom HTTP age…

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

Compose one briefing from two or three Sugra directions over HTTPS or MCP. Use when a question spans Finance, Macro, Entity, Net Atlas, News, Earth, or Research and one operation is not enough.

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