@sandbaseai/cli
Give your AI agent superpowers. One command. 2,000+ AI models and APIs.
English | 中文 | 日本語 | 한국어 | Español | Français | Deutsch | Português
Your 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.
SandBase changes that. One command connects your agent to 2,000+ AI models and APIs through the Model Context Protocol. No API keys to manage. No configuration headaches.
Building directly over HTTP instead of MCP? Start with the SandBase API quickstart or compare the unified LLM, image, and video API with specialized model gateways.
Or install the official Homebrew formula on macOS or Linux:
See the Homebrew launch announcement and macOS/Linux CI evidence.
For a reproducible install, verify the immutable release archive before
running it. The SHA-256 for sandbaseai-cli-0.1.17.tgz is
1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa.
Approve the browser authorization once; each supported client can then discover, inspect, and run available SandBase models and APIs through the local MCP bridge.
Want to inspect compatibility before signing in or changing configuration? The current
v0.1.17 GitHub release
includes a verified 25-client catalog:
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 for a compact overview.
For a security-focused walkthrough of client detection, MCP tools, and rollback,
read the 25-client SandBase CLI setup guide.
AI agents and automated installers can use the concise
llms-install.md instructions.
SandBase Open-Source Stack
- SandBase Harness — self-hosted agent runtime with persistent sessions, sandbox isolation, approvals, audit, and replay.
- SandBase Agent Skills — 88 installable Skills for research, social intelligence, marketing, and business workflows.
- SandBase for Codex — 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,
read its Registry community showcase, or find it through
Chinese Independent Developer,
Awesome MCP,
Glama,
TensorBlock MCP Index,
MCPRepository,
VaultPlane,
AIMCP,
MCP Server Hub,
MCP Server Spot, or the
Awesome AI API Proxy.
External maintainers have merged SandBase into
Awesome Codex CLI,
Awesome Agent Skills, and
Awesome MCP Server.
The Hermes integration is independently listed in the
Hermes Atlas ecosystem catalog and as beta in
Awesome Hermes Agent.
Install its
verified sandbase Agent Skill from skills.sh,
the sandbaseai/cli/sandbase listing on SkillsCat,
the sandbaseai/cli/sandbase listing on skills.re,
the 93/100 verified SandBase listing on vSkill,
the security-audited SandBase listing on Skillstore,
or the versioned sandbaseai/sandbase snapshot on Agent Skill Hub.
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:
- Use
sandbase_discoverto find candidates by task or capability. - Use
sandbase_inspectto read the current input schema, pricing, and execution requirements. - Confirm the selected endpoint, parameters, and possible cost before calling
sandbase_run. - For asynchronous work, use
sandbase_run_getwith the returnedrun_idinstead of creating a duplicate run. - Use
sandbase_runsto review recent run status and recorded cost. - Use
sandbase_accountto 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 or the Chinese workflow guide. For a live catalog example, read the GitHub connector discover-and-inspect dogfooding note.
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:
OpenClaw quickstart
Target OpenClaw directly, then ask the CLI to read back the managed MCP server and SandBase Skill before you rely on them:
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:
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:
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:
The integration is independently listed by Hermes Atlas and Awesome Hermes Agent.
How It Works
- Run
connect→ CLI opens browser auth → you approve - API key saved locally (file permissions
0600) - MCP bridge configured for your client
- Agent calls tools on-demand. No daemon. No background process.
Commands
CLI Commands
Agent Commands (shell transport, same capabilities as the MCP tools)
Agents without MCP, or with a broken MCP session, use the same catalog from a shell. Credentials come from connect automatically (or SANDBASE_API_KEY / sandbase keys add -k <key>).
-j prints JSON; errors are {"error":{"code","message","hint"}} with the next step in hint. Exit codes: 0 success or still running, 1 failure (including a failed run), 2 usage.
If api.sandbase.ai is unreachable, the CLI and the MCP bridge fall back to www.sandbase.ai automatically, and the bridge keeps the SandBase tools visible with an actionable error instead of dropping the server.
MCP Tools (available to your agent after connecting)
| Tool | Purpose |
|---|---|
sandbase_discover | Search all 2,000+ available AI models and APIs |
sandbase_inspect | Get input schema, pricing, and ready-to-use template |
sandbase_run | Execute a model or API endpoint |
sandbase_run_get | Poll status/result of an async run (video gen, etc.) |
sandbase_runs | List your recent API calls with cost breakdown |
sandbase_account | Check account balance (free, no cost) |
Recommended workflow:
Security
- Zero secrets in URLs or CLI args — OAuth device flow with PKCE
- Restricted file permissions — Credentials stored with
0600 - Ownership-aware updates — Existing JSONC comments and user-managed MCP entries are preserved
- Exact rollback — On failure or
unregister, only configuration owned by SandBase is removed - Revoke anytime — One click in the SandBase Dashboard
Get Started
Then ask your agent to do something it couldn't before.
If SandBase saves you setup time, star the repository — it helps more agent users discover the project.
Links
- SandBase Platform
- Documentation
- CLI setup guide
- CLI deep dive: English · 中文
- Six-tool practical workflow: English · 中文
- npm Package
- Official Codex Plugin
- Dashboard
Community
- Ask a question or share what you built
- Report a reproducible bug
- Propose an integration or improvement
- Contribute to SandBase CLI
Community-curated listings:
- Official Registry community showcase
- VaultPlane MCP directory
- AIMCP directory
- Awesome MCP
- Awesome AI API Proxy
- Awesome Gemini CLI
- Hermes Atlas
- Awesome Hermes Agent
- Awesome AI Tools
- Awesome MCP Server
- Awesome Agent Cortex
- Awesome AI Agent Tools
- Awesome Codex CLI
License
Apache-2.0