| Tool | What it gives you | Get it |
|---|---|---|
| Sugra API MCP server | The API as tools for an AI agent, hosted or local | mcp.sugra.ai, PyPI |
| Sugra API Skills | Procedures that teach an agent to find, call and cite the API | GitHub |
| OpenBB extension | Sugra as a data provider inside the OpenBB Platform | PyPI |
| Cookbook | Runnable Python scripts, one per task | GitHub |
pip install sugra-api-mcp. It needs Python 3.11 or later, and its source is at github.com/Sugra-Systems/sugra-api-mcp under the MIT license.sugra-api plugin for Claude Code, Codex and Grok carries all of them (plugins repository):| Skill | Use it for |
|---|---|
using-sugra-api | A map of the surfaces and product directions |
live-docs | Reading docs.sugra.ai, the OpenAPI spec and the sources list |
connect | Choosing HTTPS, hosted MCP or a local install, and setting up a client |
auth-and-quota | Keys, OAuth, and handling 401 and 429 |
discover-and-call | Finding an endpoint and calling it over HTTPS or MCP |
envelope-and-attribution | Reading the {data, meta} envelope, source names and timestamps |
cross-domain-briefing | Answering from two or three directions at once |
openbb-sugra adds Sugra as a provider to the OpenBB Platform. One key serves 141 OpenBB standard data models across fourteen command groups: equity, economy, Fama-French, ETF, currency, fixed income, index, CFTC, commodity, crypto, news, US Congress, regulators and derivatives.OPENBB_SUGRA_API_KEY environment variable, or in ~/.openbb_platform/user_settings.json under credentials, as sugra_api_key. Then pick the provider by name:openbb-core library. The Sugra API itself is a separate hosted service.pip install requests and your key in SUGRA_API_KEY; recipe 14 also needs the anthropic package. MIT license.| # | Recipe | What it shows |
|---|---|---|
| 01 | quickstart | First call, reading the envelope and the rate-limit headers |
| 02 | markets_sector_momentum | Ranking US sectors by momentum in one call |
| 03 | news_global_flow | Searching global news and trending themes |
| 04 | economics_cpi | Long-run CPI for a country |
| 05 | crypto_onchain | Bitcoin network statistics |
| 06 | network_ip_intelligence | Who runs an IP address: ASN, location, privacy signals |
| 07 | entity_sanctions_screening | Screening a name against sanctions lists |
| 08 | aviation_airport_search | Searching airports worldwide |
| 09 | food_crop_production | Crop and livestock production by country |
| 10 | forex_usd_rates | USD exchange rates |
| 11 | commodities_prices | Monthly commodity prices |
| 12 | patterns_rate_limits | Quota awareness, 429 handling, 5xx backoff |
| 13 | patterns_pagination | Offset pagination |
| 14 | agent_anthropic_mcp | An agent calling the API through the hosted MCP server |
| 15 | markets_post_earnings_moves | Earnings surprises joined with price moves |
| 16 | markets_sector_universe | The US sector map through the sector ETFs |
| 17 | forex_shop_convert | Converting a shop price with official daily exchange rates |