Give your AI agent superpowers. One command. 2,000+ AI models and APIs.
English | δΈζ | ζ₯ζ¬θͺ | νκ΅μ΄ | EspaΓ±ol | FranΓ§ais | Deutsch | PortuguΓͺs
Evidence captured from the immutable v0.1.17 release: a no-write catalog audit and a bounded doctor check against an empty isolated profile.
Homebrew users can run the same read-only check with `sandbase catalog --json`. The npm `latest` tag currently serves v0.1.14 while tokenless trusted publishing is being enabled. The GitHub release tarball is built from the immutable `v0.1.17` tag; its SHA-256 is published with the release. Visit the [official SandBase CLI project page](https://sandbaseai.github.io/cli/) for a compact overview. For a security-focused walkthrough of client detection, MCP tools, and rollback, read the [25-client SandBase CLI setup guide](https://blog.sandbase.ai/sandbase-cli-mcp-bridge-25-ai-clients/). AI agents and automated installers can use the concise [`llms-install.md`](https://github.com/sandbaseai/cli/blob/HEAD/llms-install.md) instructions. ## SandBase Open-Source Stack - **[SandBase Harness](https://github.com/sandbaseai/sandbase-harness)** β self-hosted agent runtime with persistent sessions, sandbox isolation, approvals, audit, and replay. - **[SandBase Agent Skills](https://github.com/sandbaseai/sandbase-skills)** β 88 installable Skills for research, social intelligence, marketing, and business workflows. - **[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`. Discover the authenticated remote bridge in the [official MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sandbaseai%2Fcli), read its [Registry community showcase](https://github.com/modelcontextprotocol/registry/discussions/1584), or find it through [Chinese Independent Developer](https://github.com/1c7/chinese-independent-developer/blob/master/pages/README-Programmer-Edition.md#sandbase---github), [Awesome MCP](https://github.com/AlexMili/Awesome-MCP#ai-agents--memory), [Glama](https://glama.ai/mcp/connectors/io.github.sandbaseai/cli), [TensorBlock MCP Index](https://tensorblock.co/mcp/servers/github-sandbaseai-cli-c4e113db), [MCPRepository](https://mcprepository.com/sandbaseai/cli), [VaultPlane](https://www.vaultplane.com/server/sandbase-cli), [AIMCP](https://www.aimcp.info/en/g/522d366e-114b-4d90-9f1a-552b4b3a9c86), [MCP Server Hub](https://mcpserver.dev/s/sandbase-cli_r2sjd4x), [MCP Server Spot](https://www.mcpserverspot.com/servers/sandbase-cli), or the [Awesome AI API Proxy](https://github.com/howardpen9/awesome-ai-api-proxy#global-gateways--aggregators). External maintainers have merged SandBase into [Awesome Codex CLI](https://github.com/milisp/awesome-codex-cli/pull/110), [Awesome Agent Skills](https://github.com/junminhong/awesome-agent-skills/pull/39), and [Awesome MCP Server](https://github.com/AIAnytime/Awesome-MCP-Server/pull/70). The Hermes integration is independently listed in the [Hermes Atlas](https://github.com/ksimback/hermes-ecosystem) ecosystem catalog and as beta in [Awesome Hermes Agent](https://github.com/0xNyk/awesome-hermes-agent#integrations--bridges). Install its verified [`sandbase` Agent Skill from skills.sh](https://www.skills.sh/sandbaseai/cli/sandbase), the [`sandbaseai/cli/sandbase` listing on SkillsCat](https://skills.cat/skills/sandbaseai/cli/sandbase), the [`sandbaseai/cli/sandbase` listing on skills.re](https://skills.re/skills/sandbaseai/cli/sandbase), the [93/100 verified SandBase listing on vSkill](https://verified-skill.com/skills/sandbaseai/cli/sandbase), the [security-audited SandBase listing on Skillstore](https://skillstore.io/skills/sandbaseai-sandbase), or the versioned [`sandbaseai/sandbase` snapshot on Agent Skill Hub](https://agentskillhub.dev/u/sandbaseai/sk/sandbase). --- ## A Verifiable Agent Workflow After connecting, ask your agent to follow the same inspectable sequence for search, data APIs, language models, image generation, video generation, and other catalog capabilities: 1. Use `sandbase_discover` to find candidates by task or capability. 2. Use `sandbase_inspect` to read the current input schema, pricing, and execution requirements. 3. Confirm the selected endpoint, parameters, and possible cost before calling `sandbase_run`. 4. For asynchronous work, use `sandbase_run_get` with the returned `run_id` instead of creating a duplicate run. 5. Use `sandbase_runs` to review recent run status and recorded cost. 6. Use `sandbase_account` to check the current account balance. For example, start with a non-billable discovery request: > Find image models suitable for a square product illustration. Compare the > required inputs and current pricing for the best two candidates. Do not run > either model yet. After reviewing the live response, explicitly approve the endpoint and inputs you want to run. Catalog entries, schemas, pricing, latency, and availability can change, so use the tool response from the current session rather than a static example. See the [complete Claude Code and Codex walkthrough](https://github.com/sandbaseai/cli/discussions/47) or the [Chinese workflow guide](https://github.com/sandbaseai/cli/discussions/48). For a live catalog example, read the [GitHub connector discover-and-inspect dogfooding note](https://github.com/sandbaseai/cli/discussions/57). --- ## What's Inside | Category | Tools | What You Can Do | |----------|-------|-----------------| | **Web Search** | Google, Exa, Tavily, Scholar | Research anything in real-time | | **Social Media** | Twitter/X, YouTube, Reddit, Instagram, TikTok, Xiaohongshu, Weibo, Bilibili | Monitor trends, pull posts, analyze content | | **Scraping** | Firecrawl, Exa Content | Extract data from any public webpage | | **AI Models** | GPT-4o, Claude, Gemini, DeepSeek, Qwen, Llama | Run any model without managing keys | | **Image Gen** | Flux, DALL-E, Ideogram, Recraft | Create logos, illustrations, mockups | | **Video Gen** | Kling, MiniMax, Runway, Luma | Generate short clips and animations | | **Audio** | ElevenLabs, Whisper | Text-to-speech, transcription | | **E-commerce** | Taobao, Amazon | Product research, price comparison | | **Finance** | Stock data, company info | Market research and analysis | --- ## Supported Clients (25 Targets) Works with every major AI coding tool: | Auto-configured | Manual setup | |-----------------|--------------| | Cursor, Cursor CLI | ChatGPT | | Claude Code | Claude Desktop | | Codex | | | Kiro IDE, Kiro CLI | | | Windsurf | | | Gemini CLI | | | Amp | | | Warp | | | OpenCode, Qwen Code, Kimi CLI | | | Hermes, OpenClaw | | Preview the complete compatibility catalog without signing in or changing any files: ```sh npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json ``` ```sh # Connect all detected clients at once npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect # Or target one specific client npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client cursor ``` ### OpenClaw quickstart Target OpenClaw directly, then ask the CLI to read back the managed MCP server and SandBase Skill before you rely on them: ```sh npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client openclaw npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz doctor --client openclaw ``` After `doctor` reports the credential, MCP bridge, and Skill as configured, restart OpenClaw and make a natural-language request that needs SandBase. If OpenClaw already has a non-SandBase MCP server named `sandbase`, the installer leaves it untouched instead of overwriting it. To remove the managed MCP entry and local credential later: ```sh npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz unregister --client openclaw ``` OpenClaw currently exposes no supported Skill removal command, so `unregister` reports that limitation and leaves the verified SandBase Skill installed. ### Hermes quickstart SandBase can install both its managed Hermes Skill and local MCP entry in one authorization transaction: ```sh npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client hermes npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz doctor --client hermes ``` `doctor` verifies the owned local credential, MCP entry, and Skill. Restart Hermes to confirm native discovery in a fresh client session, then use the SandBase Skill or MCP tools. A pre-existing, non-SandBase MCP entry named `sandbase` is left untouched. To remove only the managed Hermes configuration, Skill, and local credential while retaining the shared bridge for other clients: ```sh npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz unregister --client hermes ``` The integration is independently listed by [Hermes Atlas](https://github.com/ksimback/hermes-ecosystem) and [Awesome Hermes Agent](https://github.com/0xNyk/awesome-hermes-agent#integrations--bridges). --- ## How It Works ``` βββββββββββββββββββ βββββββββββββββββ ββββββββββββββββββββββ β Your Agent β MCP β Local Bridge β HTTPS β SandBase API β β (Cursor, etc.) ββββββββββΆβ (on-demand) ββββββββββΆβ 2,000+ models/APIs β β βββββββββββ βββββββββββ β βββββββββββββββββββ βββββββββββββββββ ββββββββββββββββββββββ ``` 1. Run `connect` β CLI opens browser auth β you approve 2. API key saved locally (file permissions `0600`) 3. MCP bridge configured for your client 4. Agent calls tools on-demand. No daemon. No background process. --- ## Commands ### CLI Commands ```sh sandbase connect [--client