Connector between LLM agents and world data. 643 endpoints, 75+ primary sources.
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"sugra": {
"env": {
"SUGRA_API_KEY": "sugra_xxx_yourkey..."
},
"command": "sugra-api-mcp"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Gateway connector between LLM agents and world data. Official Model Context Protocol server for the Sugra API, backed by a bundled endpoint catalog and operation_id calls.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
uvx 'sugra-api-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked sugra-api-mcp against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in data
Zero-dependency, token-efficient database MCP server for Postgres, MySQL, SQL Server, MariaDB, SQLite.
🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.
Manage Supabase projects — databases, auth, storage, and edge functions
A Model Context Protocol server that provides read-only access to MySQL databases. This server enables LLMs to inspect database schemas and execute read-only queries.
MCP Security Weekly
Get CVE alerts and security updates for io.github.Sugra-Systems/sugra-api-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
PyPI v0.8.2 | Python 3.11+ | MIT
Gateway connector between LLM agents and world data. Official Model Context Protocol server for the Sugra API, backed by a bundled endpoint catalog and operation_id calls.
Works with Anthropic Claude, OpenAI GPT, Google Gemini, xAI, and any MCP-enabled IDE.
Client details:
Current release: eight-tool surface with hosted OAuth activity validation for https://app.sugra.ai/mcp, plus ChatGPT Apps-compatible OAuth tool metadata. Curated tool names such as get_market_price, get_macro_indicator, and get_news are not part of this package. The package exposes exactly eight tools:
| Tool | Purpose |
|---|---|
fetch_data | One-step: find best endpoint for a natural-language query and call it. Combines search + call in one round trip. |
search_endpoints | Search the bundled endpoint catalog. Runtime search does not fetch /openapi.json. |
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. |
list_toolsets | List catalog groups with endpoint counts and descriptions. |
list_sources | Show bundled catalog source metadata. |
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). |
call_endpoint and fetch_data both support response shaping with limit, fields, and include_raw. Shaping works on enveloped ({"data": ...}) and envelope-less payloads alike; fields entries may use dotted paths into nested objects (geo.city), and meta.shaped reports what was actually applied (fields_applied / fields_unmatched, limit_applied) rather than echoing the request.
describe_endpoint returns computed agent_hints per endpoint so agents can budget time and parallelism before calling:
duration_class - fast (under ~2s, snapshot-backed), slow (live upstream proxying, occasionally 15s+), or heavy (per-item upstream work, large batches can exceed the gateway timeout)max_concurrency - advisory ceiling for parallel calls from one sessionbulk_cost - on per-item bulk endpoints: 1 request credit per item in the request body (the API reports the total in the X-RateLimit-Cost response header)The hosted MCP endpoint at https://app.sugra.ai/mcp serves the same eight tools PLUS three composed agent tools that are not available on stdio or self-hosted installs:
| Tool | Purpose |
|---|---|
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 |