sugra-systems/sugra-api-skills
Skills for the Sugra API: find the right endpoint, call it with the right parameters over HTTPS or MCP, and cite the source and date of every figure.
Use a Sugra key, stay inside the daily quota, and act on each error over HTTPS or MCP. Use when the user needs a key, before a bulk call, or when a call returns 400, 401, 404, 422, 429, 5xx, missing_api_key, missing_bearer_token, unknown_parameters, needs_params, or upstream_*.
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.
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 figure, or after a catalog miss. Confirm details on https://docs.sugra.ai. Do not invent routes.
Load this skill first, before search_endpoints or any other Sugra tool, whenever a question asks about conditions at a place - weather observed, forecast or past, climate normals and projections, natural hazards and warnings, rivers, tides and water levels, power grids, crops and growing-season weather, disruption to ports, flights and roads - or how such an event feeds energy, commodity or output data. It names the call for each. Not for macro series, market prices or news alone.
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.
Find current Sugra documentation. Use when an endpoint, parameter, default, or version might be stale. Canonical docs are https://docs.sugra.ai (search and Ask AI). Also OpenAPI, /sources, the blog, and MCP tools/list.
Load this skill first, before search_endpoints or any other Sugra tool, whenever a question asks for an economic figure or how an economy is doing - inflation and price indexes, jobs and unemployment, GDP and recession signals, policy rates and bond yields, mortgage rates and housing, money and central banks, debt and deficits, trade balances, release dates and meetings, or comparisons across countries. It names the call for each. Not for company fundamentals, market quotes, news or weather.
Load this skill first, before search_endpoints or any other Sugra tool, whenever a question asks how a market instrument is priced or trading - stock, fund and index prices, earnings against expectations, yields and spreads, volatility and options, positioning and flows, exchange rates, commodities and futures curves, crypto, prediction-market odds, or comparisons across instruments. It names the call for each. Not for macro releases (macro-data), news (news-data) or weather (earth-data).
Load this skill first, before search_endpoints or any other Sugra tool, whenever a question asks what happened to a company, person, country or topic over a window - news coverage and its tone or volume, a reported event to check, filings and current reports, press releases, sanctions and watchlist screens, the status of a bill or law, or whether a news item explains a market move. It names the call for each record and the reading rules. Not for market prices alone, macro series or weather.
Work with the Sugra API over HTTPS and MCP. Use when the task needs Sugra data, a key, product directions (Finance, Macro, Entity, Net Atlas, News, Earth, Research), or which skill to load next.