{"id":20503,"plugin_id":"plugins_6aa4f7db79848191a81e4048990545ef","kind":"skill","collection_source":null,"comparison_source":null,"observed_at":"2026-09-30T23:16:17.458Z","digest":"40838d7423b4d9241f8d6ab0caebfc64c45245db3337a5fb1c348f7e7160eb71","against":null,"payload":{"description":"Attach a client to Sugra over HTTPS or MCP. Use when setting up Claude Desktop, Claude Code, ChatGPT, claude.ai, Cursor, VS Code, Gemini CLI, Grok, OpenBB, a custom HTTP agent, or self-hosted MCP.","included_files":[{"relative_path":"agents/openai.yaml","size_in_bytes":194},{"relative_path":"references/clients.md","size_in_bytes":1495}],"name":"connect","skill_md_contents":"---\nname: connect\ndescription: Attach a client to Sugra over HTTPS or MCP. Use when setting up Claude Desktop, Claude Code, ChatGPT, claude.ai, Cursor, VS Code, Gemini CLI, Grok, OpenBB, a custom HTTP agent, or self-hosted MCP.\nlicense: MIT\n---\n\n# Connect\n\nSame key for every path: https://app.sugra.ai/settings/billing, prefix `sugra_...`. Do not log it. Client JSON blocks: [references/clients.md](references/clients.md).\n\n## 1. HTTPS API\n\n```\nGET https://sugra.ai/api/v1/...\nx-api-key: sugra_...\n```\n\nSystem endpoints (`/health`, `/about`, `/services`, `/sources`, `/openapi.json`) need no key. Recipes: https://github.com/Sugra-Systems/sugra-api-cookbook. Endpoint detail: https://docs.sugra.ai.\n\n## 2. Hosted MCP\n\nCanonical: `https://mcp.sugra.ai/mcp`\nPermanent alias: `https://app.sugra.ai/mcp`\n\nAuth: `Authorization: Bearer sugra_...` or OAuth (audience `https://app.sugra.ai/mcp`, scope `sugra:read`). Discovery is public. `tools/call` and `resources/read` need Bearer.\n\nclaude.ai: Settings -> Connectors -> Add custom connector.\nChatGPT: install skills from the Plugins Directory (https://chatgpt.com/plugins/plugins_6aa4f7db79848191a81e4048990545ef). Hosted MCP tools: Settings -> Connectors -> Add MCP server.\n\nHosted tools: 8 gateway plus 3 composed (`resolve_entity`, `get_snapshot`, `get_timeseries`). Confirm with live `tools/list`.\n\n## 3. Local MCP stdio\n\n```bash\npip install sugra-api-mcp\nexport SUGRA_API_KEY=sugra_...\n```\n\nEight gateway tools. Catalog search works without the key; `call_endpoint` / `fetch_data` / entity tools return `missing_api_key` until it is set. If the console script is not on PATH: `\"command\": \"python\", \"args\": [\"-m\", \"sugra_api_mcp\"]`.\n\nPackage CLI: `sugra-api-mcp doctor`, `search`, `describe`, `call`.\n\nClaude Desktop, Claude Code, Gemini CLI, Cursor, VS Code, and similar IDEs use the stdio block in [references/clients.md](references/clients.md), or the hosted URL with Bearer.\n\n## 4. Self-hosted MCP HTTP\n\n```bash\nsugra-api-mcp --transport streamable-http --port 8001\n```\n\nEight tools, not the hosted-only three. Operator CORS/host/OAuth: `docs/self-hosting.md` in `sugra-api-mcp`. Do not put `INTERNAL_API_TOKEN` or JWKS URLs in a skill or chat.\n\n## 5. OpenBB\n\nPublic extension `openbb-sugra` uses the HTTPS API, not MCP.\n\n## Pick\n\n| Host | Typical attach |\n|---|---|\n| Script, custom agent, OpenBB | HTTPS `x-api-key` |\n| ChatGPT | Plugins Directory listing plus hosted MCP |\n| claude.ai | Hosted MCP connector |\n| Claude Desktop / Code, Cursor, VS Code, Gemini CLI, Grok | stdio package or hosted MCP |\n| Own HTTP MCP process | self-host |\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}