{"id":20508,"plugin_id":"plugins_6aa4f7db79848191a81e4048990545ef","kind":"skill","collection_source":null,"comparison_source":null,"observed_at":"2026-09-30T23:16:17.557Z","digest":"150aa5560288a4ae5c3c1f6b959e9ca21a28267547d6e8de7dc8eb3efacedbfc","against":null,"payload":{"description":"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.","included_files":[{"relative_path":"agents/openai.yaml","size_in_bytes":212}],"name":"using-sugra-api","skill_md_contents":"---\nname: using-sugra-api\ndescription: 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.\nlicense: MIT\n---\n\n# Using the Sugra API\n\nSugra API is intelligence infrastructure: one HTTP API, one key, seven product directions. Domain-agnostic. Do not frame it through one vertical.\n\nThe surface is LLM-friendly: one `x-api-key`, one JSON envelope `{data, meta}` on every direction, MCP as the agent-native entry. Documentation truth is https://docs.sugra.ai (search and Ask AI). This skill is a map, not the catalog.\n\nThese files are English. Reply in the user's language.\n\nPublic hedge (not a live count): 1,500+ endpoints, 160+ primary sources, 36 domains. Live counts: skill `live-docs`.\n\n## Two complete ways in\n\n| Surface | When | How |\n|---|---|---|\n| HTTPS `https://sugra.ai` | The agent can GET/POST | `x-api-key` on `/api/v1/...` |\n| MCP | The host is an MCP client | hosted `https://mcp.sugra.ai/mcp` or local `sugra-api-mcp` |\n\nBoth reach the same API. Use the surface the host already has, or the one the user named. Key: https://app.sugra.ai/settings/billing (Free: 50 requests/day). Do not log the key.\n\n## Seven directions (one key, one budget)\n\n| Direction | Coverage |\n|---|---|\n| Sugra Finance | Equities, fundamentals, filings, fixed income, derivatives, crypto, forex |\n| Sugra Macro | Central banks, national statistics, FRED, IMF, World Bank, OECD |\n| Sugra Entity | Company resolution, sanctions and watchlist screening, identifiers |\n| Sugra Net Atlas | Internet infrastructure: ASNs, prefixes, IXPs, routing, DNS |\n| Sugra News | Global news flow and event signals |\n| Sugra Earth | Weather, hazards, energy, transport, air quality, climate |\n| Sugra Research | Scientific, patent, and academic datasets |\n\n## Skill map\n\n| Need | Skill |\n|---|---|\n| Live docs, search, Ask AI, sources, blog | `live-docs` |\n| Attach HTTP, hosted MCP, stdio, self-host, each client | `connect` |\n| Key, plans, 401/429, Bearer vs `x-api-key` | `auth-and-quota` |\n| Find and call an operation (HTTP and MCP) | `discover-and-call` |\n| Envelope, sources, clocks, MCP shaping | `envelope-and-attribution` |\n| Two or three directions in one answer | `cross-domain-briefing` |\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}