[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_130":131},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":47,"_49":50,"_51":52,"_53":54,"_55":-5,"_56":47,"_57":58,"_59":60,"_61":62,"_63":64,"_65":66,"_67":47,"_68":69,"_70":71,"_72":73,"_74":75,"_76":77,"_78":-5,"_79":-5,"_80":-5,"_81":47,"_82":-5,"_83":84,"_85":86,"_87":88,"_89":90,"_91":92,"_93":94,"_95":96},"apiUrl","https://odel.app/api","creator","sandbaseai","moduleId","cli","@sandbaseai/cli","displayName","SandBase","tagline","Connect MCP clients to 2,000+ AI models without managing provider API keys.","iconKey","https://avatars.githubusercontent.com/u/271874822?v=4","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://sandbase.ai/v1/mcp\",\"transport\":\"streamable-http\",\"authType\":\"bearer\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1788069459000,"updatedAt","sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.sandbaseai%2Fcli","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",79,"upstreamUpdatedAt",1787920782000,"detectedTransport","streamable-http","detectedAuthType","bearer","probeStatus","ok","lastProbedAt","githubRepoUrl","https://github.com/sandbaseai/cli","githubRepoFullName","sandbaseai/cli","releaseId","ext-sandbaseai-cli","version","0.1.17","descriptionMarkdown","

@sandbaseai/cli

\n Give your AI agent superpowers. One command. 2,000+ AI models and APIs.\n

\n $\"GitHub$ \n $\"CI\"$ \n $\"Official$ \n $\"Indexed$ \n $\"License\"$ \n $\"GitHub$ \n

\n\n

\n $\"SandBase$ \n

\n\n---\n\nYour AI coding assistant is smart, but it's trapped in a box. It can't search the web, check social media, generate images, or access real-time data — unless you wire up each API yourself.\n\n**SandBase changes that.** One command connects your agent to 2,000+ AI models and APIs through the [Model Context Protocol](https://modelcontextprotocol.io). No API keys to manage. No configuration headaches.\n\nBuilding directly over HTTP instead of MCP? Start with the [SandBase API quickstart](https://www.sandbase.ai/docs/getting-started/)\nor compare the unified [LLM, image, and video API](https://blog.sandbase.ai/unified-ai-api-llm-image-video-2026/)\nwith specialized model gateways.\n\n```sh\nnpx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect\n```\n\nOr install the official Homebrew formula on macOS or Linux:\n\n```sh\nbrew install sandbaseai/tap/sandbaseai-cli\nsandbase connect\n```\n\nSee the [Homebrew launch announcement and macOS/Linux CI evidence](https://github.com/sandbaseai/cli/discussions/55).\n\nFor a reproducible install, verify the immutable release archive before\nrunning it. The SHA-256 for `sandbaseai-cli-0.1.17.tgz` is\n`1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa`.\n\n```sh\ncurl -fL -o sandbaseai-cli-0.1.17.tgz \\\n https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz\necho '1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa sandbaseai-cli-0.1.17.tgz' | shasum -a 256 -c -\nnpx -y ./sandbaseai-cli-0.1.17.tgz connect\n```\n\nApprove the browser authorization once; each supported client can then discover,\ninspect, and run available SandBase models and APIs through the local MCP bridge.\n\nWant to inspect compatibility before signing in or changing configuration? The current\n[`v0.1.17` GitHub release](https://github.com/sandbaseai/cli/releases/tag/v0.1.17)\nincludes a verified 25-client catalog:\n\n```sh\nnpx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json\n```\n\n

\n $\"Read-only$ \n $\"SandBase$ \n

_{Evidence captured from the immutable v0.1.17 release: a no-write catalog audit and a bounded doctor check against an empty isolated profile.}

\n\nHomebrew users can run the same read-only check with `sandbase catalog --json`.\n\nThe npm `latest` tag currently serves v0.1.14 while tokenless trusted publishing is\nbeing enabled. The GitHub release tarball is built from the immutable `v0.1.17` tag;\nits SHA-256 is published with the release.\n\nVisit the [official SandBase CLI project page](https://sandbaseai.github.io/cli/) for a compact overview.\nFor a security-focused walkthrough of client detection, MCP tools, and rollback,\nread the [25-client SandBase CLI setup guide](https://blog.sandbase.ai/sandbase-cli-mcp-bridge-25-ai-clients/).\nAI agents and automated installers can use the concise\n[`llms-install.md`](https://github.com/sandbaseai/cli/blob/main/llms-install.md) instructions.\n\n## SandBase Open-Source Stack\n\n- **[SandBase Harness](https://github.com/sandbaseai/sandbase-harness)** — self-hosted agent runtime with persistent sessions, sandbox isolation, approvals, audit, and replay.\n- **[SandBase Agent Skills](https://github.com/sandbaseai/sandbase-skills)** — 88 installable Skills for research, social intelligence, marketing, and business workflows.\n- **[SandBase for Codex](https://github.com/sandbaseai/sandbase-codex-plugin)** — official Codex plugin packaging the SandBase MCP bridge and guided Agent Skill; its required HOL security scan passes on `main`.\n\nDiscover the authenticated remote bridge in the [official MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sandbaseai%2Fcli),\nread its [Registry community showcase](https://github.com/modelcontextprotocol/registry/discussions/1584), or find it through\n[Chinese Independent Developer](https://github.com/1c7/chinese-independent-developer/blob/master/pages/README-Programmer-Edition.md#sandbase---github),\n[Awesome MCP](https://github.com/AlexMili/Awesome-MCP#ai-agents--memory),\n[Glama](https://glama.ai/mcp/connectors/io.github.sandbaseai/cli),\n[TensorBlock MCP Index](https://tensorblock.co/mcp/servers/github-sandbaseai-cli-c4e113db),\n[MCPRepository](https://mcprepository.com/sandbaseai/cli),\n[VaultPlane](https://www.vaultplane.com/server/sandbase-cli),\n[AIMCP](https://www.aimcp.info/en/g/522d366e-114b-4d90-9f1a-552b4b3a9c86),\n[MCP Server Hub](https://mcpserver.dev/s/sandbase-cli_r2sjd4x),\n[MCP Server Spot](https://www.mcpserverspot.com/servers/sandbase-cli), or the\n[Awesome AI API Proxy](https://github.com/howardpen9/awesome-ai-api-proxy#global-gateways--aggregators).\nExternal maintainers have merged SandBase into\n[Awesome Codex CLI](https://github.com/milisp/awesome-codex-cli/pull/110),\n[Awesome Agent Skills](https://github.com/junminhong/awesome-agent-skills/pull/39), and\n[Awesome MCP Server](https://github.com/AIAnytime/Awesome-MCP-Server/pull/70).\nThe Hermes integration is independently listed in the\n[Hermes Atlas](https://github.com/ksimback/hermes-ecosystem) ecosystem catalog and as beta in\n[Awesome Hermes Agent](https://github.com/0xNyk/awesome-hermes-agent#integrations--bridges).\nInstall its\nverified [`sandbase` Agent Skill from skills.sh](https://www.skills.sh/sandbaseai/cli/sandbase),\nthe [`sandbaseai/cli/sandbase` listing on SkillsCat](https://skills.cat/skills/sandbaseai/cli/sandbase),\nthe [`sandbaseai/cli/sandbase` listing on skills.re](https://skills.re/skills/sandbaseai/cli/sandbase),\nthe [93/100 verified SandBase listing on vSkill](https://verified-skill.com/skills/sandbaseai/cli/sandbase),\nthe [security-audited SandBase listing on Skillstore](https://skillstore.io/skills/sandbaseai-sandbase),\nor the versioned [`sandbaseai/sandbase` snapshot on Agent Skill Hub](https://agentskillhub.dev/u/sandbaseai/sk/sandbase).\n\n---\n\n## A Verifiable Agent Workflow\n\nAfter connecting, ask your agent to follow the same inspectable sequence for\nsearch, data APIs, language models, image generation, video generation, and\nother catalog capabilities:\n\n1. Use `sandbase_discover` to find candidates by task or capability.\n2. Use `sandbase_inspect` to read the current input schema, pricing, and\n execution requirements.\n3. Confirm the selected endpoint, parameters, and possible cost before calling\n `sandbase_run`.\n4. For asynchronous work, use `sandbase_run_get` with the returned `run_id`\n instead of creating a duplicate run.\n5. Use `sandbase_runs` to review recent run status and recorded cost.\n6. Use `sandbase_account` to check the current account balance.\n\nFor example, start with a non-billable discovery request:\n\n> Find image models suitable for a square product illustration. Compare the\n> required inputs and current pricing for the best two candidates. Do not run\n> either model yet.\n\nAfter reviewing the live response, explicitly approve the endpoint and inputs\nyou want to run. Catalog entries, schemas, pricing, latency, and availability\ncan change, so use the tool response from the current session rather than a\nstatic example.\n\nSee the [complete Claude Code and Codex walkthrough](https://github.com/sandbaseai/cli/discussions/47)\nor the [Chinese workflow guide](https://github.com/sandbaseai/cli/discussions/48). For a live\ncatalog example, read the [GitHub connector discover-and-inspect dogfooding note](https://github.com/sandbaseai/cli/discussions/57).\n\n---\n\n## What's Inside\n\n| Category | Tools | What You Can Do |\n|----------|-------|-----------------|\n| **Web Search** | Google, Exa, Tavily, Scholar | Research anything in real-time |\n| **Social Media** | Twitter/X, YouTube, Reddit, Instagram, TikTok, Xiaohongshu, Weibo, Bilibili | Monitor trends, pull posts, analyze content |\n| **Scraping** | Firecrawl, Exa Content | Extract data from any public webpage |\n| **AI Models** | GPT-4o, Claude, Gemini, DeepSeek, Qwen, Llama | Run any model without managing keys |\n| **Image Gen** | Flux, DALL-E, Ideogram, Recraft | Create logos, illustrations, mockups |\n| **Video Gen** | Kling, MiniMax, Runway, Luma | Generate short clips and animations |\n| **Audio** | ElevenLabs, Whisper | Text-to-speech, transcription |\n| **E-commerce** | Taobao, Amazon | Product research, price comparison |\n| **Finance** | Stock data, company info | Market research and analysis |\n\n---\n\n## Supported Clients (25 Targets)\n\nWorks with every major AI coding tool:\n\n| Auto-configured | Manual setup |\n|-----------------|--------------|\n| Cursor, Cursor CLI | ChatGPT |\n| Claude Code | Claude Desktop |\n| Codex | |\n| Kiro IDE, Kiro CLI | |\n| Windsurf | |\n| Gemini CLI | |\n| Amp | |\n| Warp | |\n| OpenCode, Qwen Code, Kimi CLI | |\n| Hermes, OpenClaw | |\n\nPreview the complete compatibility catalog without signing in or changing any files:\n\n```sh\nnpx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json\n```\n\n```sh\n# Connect all detected clients at once\nnpx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect\n\n# Or target one specific client\nnpx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client cursor\n```\n\n### OpenClaw quickstart\n\nTarget OpenClaw directly, then ask the CLI to read back the managed MCP server\nand SandBase Skill before you rely on them:\n\n```sh\nnpx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client openclaw\nnpx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz doctor --client openclaw\n```\n\nAfter `doctor` reports the credential, MCP bridge, and Skill as configured,\nrestart OpenClaw and make a natural-language request that needs SandBase. If\nOpenClaw already has a non-SandBase MCP server named `sandbase`, the installer\nleaves it untouched instead of overwriting it. To remove the managed MCP entry\nand local credential later:\n\n```sh\nnpx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz unregister --client openclaw\n```\n\nOpenClaw currently exposes no supported Skill removal command, so `unregister`\nreports that limitation and leaves the verified SandBase Skill installed.\n\n### Hermes quickstart\n\nSandBase can install both its managed Hermes Skill and local MCP entry in one\nauthorization transaction:\n\n```sh\nnpx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client hermes\nnpx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz doctor --client hermes\n```\n\n`doctor` verifies the owned local credential, MCP entry, and Skill. Restart\nHermes to confirm native discovery in a fresh client session, then use the\nSandBase Skill or MCP tools. A pre-existing, non-SandBase MCP entry named\n`sandbase` is left untouched. To remove only the managed Hermes configuration,\nSkill, and local credential while retaining the shared bridge for other clients:\n\n```sh\nnpx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz unregister --client hermes\n```\n\nThe integration is independently listed by\n[Hermes Atlas](https://github.com/ksimback/hermes-ecosystem) and\n[Awesome Hermes Agent](https://github.com/0xNyk/awesome-hermes-agent#integrations--bridges).\n\n---\n\n## How It Works\n\n```\n┌─────────────────┐ ┌───────────────┐ ┌────────────────────┐\n│ Your Agent │ MCP │ Local Bridge │ HTTPS │ SandBase API │\n│ (Cursor, etc.) │────────▶│ (on-demand) │────────▶│ 2,000+ models/APIs │\n│ │◀────────│ │◀────────│ │\n└─────────────────┘ └───────────────┘ └────────────────────┘\n```\n\n1. Run `connect` → CLI opens browser auth → you approve\n2. API key saved locally (file permissions `0600`)\n3. MCP bridge configured for your client\n4. Agent calls tools on-demand. No daemon. No background process.\n\n---\n\n## Commands\n\n### CLI Commands\n\n```sh\nsandbase connect [--client ] # Authorize + configure\nsandbase doctor [--client ] # Health check\nsandbase unregister [--client ] # Remove configuration\nsandbase catalog --json # List all supported clients\n```\n\n### MCP Tools (available to your agent after connecting)\n\n| Tool | Purpose |\n|------|---------|\n| `sandbase_discover` | Search all 2,000+ available AI models and APIs |\n| `sandbase_inspect` | Get input schema, pricing, and ready-to-use template |\n| `sandbase_run` | Execute a model or API endpoint |\n| `sandbase_run_get` | Poll status/result of an async run (video gen, etc.) |\n| `sandbase_runs` | List your recent API calls with cost breakdown |\n| `sandbase_account` | Check account balance (free, no cost) |\n\n**Recommended workflow:**\n\n```\ndiscover → inspect → run\n```\n\n```\n1. sandbase_discover(q: \"twitter search\") → find current candidates\n2. sandbase_inspect(name: discovered_name) → get schema and pricing\n3. sandbase_run(name: discovered_name, input: {...}) → run after confirmation\n```\n\n---\n\n## Security\n\n- **Zero secrets in URLs or CLI args** — OAuth device flow with PKCE\n- **Restricted file permissions** — Credentials stored with `0600`\n- **Ownership-aware updates** — Existing JSONC comments and user-managed MCP entries are preserved\n- **Exact rollback** — On failure or `unregister`, only configuration owned by SandBase is removed\n- **Revoke anytime** — One click in the [SandBase Dashboard](https://sandbase.ai/console/keys)\n\n---\n\n## Get Started\n\n```sh\nnpx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect\n```\n\nThen ask your agent to do something it couldn't before.\n\n**[Create a free account →](https://sandbase.ai)**\n\nIf SandBase saves you setup time, [star the repository](https://github.com/sandbaseai/cli) — it helps more agent users discover the project.\n\n---\n\n## Links\n\n- [SandBase Platform](https://sandbase.ai)\n- [Documentation](https://www.sandbase.ai/docs/)\n- [CLI setup guide](https://www.sandbase.ai/docs/setup/cli)\n- CLI deep dive: [English](https://blog.sandbase.ai/sandbase-cli-mcp-bridge-25-ai-clients/) · [中文](https://blog.sandbase.ai/zh-CN/sandbase-cli-mcp-bridge-25-ai-clients/)\n- Six-tool practical workflow: [English](https://github.com/sandbaseai/cli/discussions/47) · [中文](https://github.com/sandbaseai/cli/discussions/48)\n- [npm Package](https://www.npmjs.com/package/@sandbaseai/cli)\n- [Official Codex Plugin](https://github.com/sandbaseai/sandbase-codex-plugin)\n- [Dashboard](https://sandbase.ai/console)\n\n## Community\n\n- [Ask a question or share what you built](https://github.com/sandbaseai/cli/discussions)\n- [Report a reproducible bug](https://github.com/sandbaseai/cli/issues/new?template=bug-report.yml)\n- [Propose an integration or improvement](https://github.com/sandbaseai/cli/issues/new?template=feature-request.yml)\n- [Contribute to SandBase CLI](https://github.com/sandbaseai/cli/blob/main/CONTRIBUTING.md)\n\nCommunity-curated listings:\n\n- [Official Registry community showcase](https://github.com/modelcontextprotocol/registry/discussions/1584)\n- [VaultPlane MCP directory](https://www.vaultplane.com/server/sandbase-cli)\n- [AIMCP directory](https://www.aimcp.info/en/g/522d366e-114b-4d90-9f1a-552b4b3a9c86)\n- [Awesome MCP](https://github.com/AlexMili/Awesome-MCP)\n- [Awesome AI API Proxy](https://github.com/howardpen9/awesome-ai-api-proxy)\n- [Awesome Gemini CLI](https://github.com/Piebald-AI/awesome-gemini-cli)\n- [Hermes Atlas](https://github.com/ksimback/hermes-ecosystem)\n- [Awesome Hermes Agent](https://github.com/0xNyk/awesome-hermes-agent)\n- [Awesome AI Tools](https://github.com/QAInsights/awesome-ai-tools)\n- [Awesome MCP Server](https://github.com/AIAnytime/Awesome-MCP-Server)\n- [Awesome Agent Cortex](https://github.com/0xNyk/awesome-agent-cortex)\n- [Awesome AI Agent Tools](https://github.com/michielhdoteth/awesome-ai-agent-tools)\n- [Awesome Codex CLI](https://github.com/milisp/awesome-codex-cli)\n\n## License\n\nApache-2.0\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"iconType","image","upstream",{"_113":114,"_115":116,"_117":118,"_119":120,"_121":122,"_123":124},"requiredSecrets",[],"tags",[99,100,101,102,103,104,21,105,106,107,108,109,110,111,112],"assets",[],"stats",{"_97":84,"_98":84},"ratingAvg","reviewCount","agent-skills","ai-agents","ai-coding","ai-gateway","chatgpt","claude-code","codex","cursor","gemini-cli","hermes-agent","llm","model-routing","multimodal-ai","openclaw","topics",[99,100,101,102,103,104,21,105,106,107,108,109,125,126,127,110,111,112,128,129],"license","Apache-2.0","language","TypeScript","registryName","io.github.sandbaseai/cli","homepage","https://sandbaseai.github.io/cli/","packages",[],"mcp","mcp-server","model-context-protocol","opencode","windsurf","ENV",{"_132":133,"_134":135,"_136":137},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]