Prod Sugra Ai MCP

general MCP Server

Sugra MCP: connector between LLM agents and world data. 1,400+ endpoints aggregating 130+ primary sources across 32 data domains: markets, macroeconomics, company fundamentals, government, news, climate, maritime, trade, and entity screening. Works with Anthropic Claude, OpenAI GPT, Google Gemini, xAI, and any MCP-enabled client.

VerifiedInstall Ready
generalgeneralgcp
4 views1 stars0 forksMIT

Why This Matters

Discovered via github-topic:model-context-protocol and last synced 3mo ago.

VerifiedInstall Ready
Source
github-topic:model-context-protocol
Stars
1
Last synced
3mo ago
Install
Instructions detected

Install

1. Install the package

pip install sugra-api-mcp
26
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (26)

SUGRA_MCP_ALLOWED_HOSTS

No (HTTP)

list_toolsets

List catalog groups with endpoint counts and descriptions.

Variable

Required

SUGRA_JWKS_URL

No

Tool

Purpose

SUGRA_API_KEY

Yes (stdio)

INTERNAL_API_TOKEN

HTTP + OAuth

SUGRA_MCP_ALLOWED_ORIGINS

No (HTTP)

search_endpoints

Search the bundled endpoint catalog. Runtime search does not fetch `/openapi.json`.

SUGRA_TIMEOUT

No

fetch_data

One-step: find best endpoint for a natural-language query and call it. Combines search + call in one round trip.

SUGRA_API_BASE

No

list_sources

Show bundled catalog source metadata.

SUGRA_APP_URL

HTTP + OAuth

describe_endpoint

Inspect an endpoint by `operation_id`, including path, method, parameters, required inputs, `agent_hints`, and `request_body_schema` for JSON-body POST operations.

call_endpoint

Call a Sugra API operation by `operation_id`. Arbitrary path calls are no longer supported.

sugra_entity_screen

Screen a name against sanctions and watchlists (Sugra Entity).

sugra_entity_lookup

Composed entity lookup by identifier - `anchor` is `lei` or `vat`, plus the identifier `value`; returns registry identity + screening (Sugra Entity).

resolve_entity

Free text (ticker, company, indicator, coin, currency pair) to a canonical market or macro entity. Ambiguous matches return ranked candidates, never a silent pick.

get_snapshot

Entity plus a named recipe to one composed current view with freshness, provenance, coverage, and billing blocks. Composed calls charge a fixed recipe cost (1-2 requests) from the daily quota.

get_timeseries

Entity plus metric (`price`, `macro_series`, `etf_flows`) to a bounded series with an explicit downsampling flag.

Meaning

Retry strategy

upstream_timeout

No response within `SUGRA_TIMEOUT` (`elapsed_ms` close to `timeout_s` x 1000)

upstream_connect_error

Could not reach the Sugra API (DNS failure, connection refused)

upstream_transport_error

Connection dropped mid-request

tool_execution_failed

Unexpected failure inside the gateway (`exception_type` included)