SandBase CLI MCP
A CLI and MCP bridge giving Claude Code, Cursor, Codex and 22 more clients 2,000+ models and APIs on one balance
- 186 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- Running models and some APIs charges money from the balance, and requests and data go to an external gateway.
- The `connect` command changes the configuration of installed clients and stores a key in a local file.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/sandbase-cliDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Running models and some APIs charges money from the balance, and requests and data go to an external gateway.
- The `connect` command changes the configuration of installed clients and stores a key in a local file.
This is third-party code. Review the repository files before installing.
What it does
SandBase CLI is a command-line program and a local MCP bridge that connect an AI client to a catalog of over 2,000 models and APIs: web search, social networks, scraping, shops, financial data, language models, and image, video and audio generation. The `connect` command finds installed clients, opens a browser sign-in over OAuth with PKCE, stores the key locally with `0600` permissions and writes MCP into the configuration. 25 clients are supported, among them Cursor, Claude Code, Codex, Windsurf, Gemini CLI, Amp, OpenCode, Hermes and OpenClaw. Once connected, the agent gets the tools `sandbase_discover`, `sandbase_inspect`, `sandbase_run`, `sandbase_run_get`, `sandbase_runs`, `sandbase_account` and `sandbase_run_cancel`. The workflow is to find a tool, read its input schema and price, and run it after confirmation. Search, price inspection, run status, balance and file upload are free, while model runs are paid per call or per million tokens from a single balance. Agents without MCP get the same capabilities as shell commands.
Who it is for. Agent developers who want search, social data and media generation in Claude Code, Cursor or Codex without a separate key for each service.
Good fit when
- An agent needs data from social networks or marketplaces and writing a scraper per site is not appealing.
- Cursor, Claude Code and Codex are connected to a shared tool set with one `connect` command.
- A model or API is checked before paying: `sandbase inspect` shows the input schema and price while nothing is charged.
- An agent started a video generation and the result is collected later by `run_id` without creating a duplicate run.
- Client compatibility is checked without writing anything: `catalog --json` changes nothing and needs no account.
Not a fit when
- You do not want an account and a balance: the tools do not work without the browser sign-in.
- The service you need already has its own MCP server or key: the SandBase skill itself advises using them.
- Requests and data must not go to an external gateway: every call goes through `api.sandbase.ai`.
- The call budget has to stay fixed: prices for models and APIs change.
Example request
Find image models through SandBase for a square product illustration, compare the inputs and price of the best two and run nothing yet.MCP
- Transport
- stdio, http
- Authentication
- OAuth
Environment variables
SANDBASE_API_KEYsecret- A SandBase key for when the `connect` sign-in is unavailable, for example in a shell without MCP.
Limitations
The catalog is paid. A hundred free calls a day apply to eligible data APIs, are shared per organization and reset at 00:00 UTC, while model calls are charged straight away. `sandbase inspect` shows the exact price before a run. Signing in needs a SandBase account and a browser approval, and the key is stored locally and revoked in the service console. Node.js 20 or newer is required. ChatGPT and Claude Desktop are configured by hand; the other clients are configured automatically. After upgrading the CLI run `sandbase setup` to refresh the bridge and the skill.
How to disable. Run `npx -y @sandbaseai/cli@latest unregister` to remove only the configuration entries and the local key created by the CLI. For one client add `--client <name>`. The key can be revoked in the SandBase console.
FAQ
How do I connect SandBase to Claude Code?
Run `npx -y @sandbaseai/cli@latest connect`, or add `--client claude-code` for a single client. Approve the sign-in in the browser and start a new session so the `sandbase_*` tools load.
How much does SandBase cost?
Search, schema and price inspection, run status, balance and file upload are free. Eligible data APIs give 100 free calls a day per organization, then a call is charged. Models are charged per call or per million tokens.
How do I check that the connection works?
`sandbase doctor --client <name>` checks the key, the MCP bridge and the skill and makes one real request to the service. If you are not ready to install yet, `catalog --json` lists supported clients with no writes and no sign-in.
How do I remove the SandBase configuration?
Run `unregister`: it removes only what the CLI created, plus the local key. For OpenClaw the command reports that skill removal is unavailable there and leaves the verified skill in place.
What protects the key and client configurations?
Sign-in uses the OAuth device flow with PKCE, secrets stay out of URLs and command arguments, and the key sits in a file with `0600` permissions. The CLI leaves a foreign entry named `sandbase` alone; on failure it rolls back only its own changes.
Discussion
No questions or reviews yet.
Related
MCP serversA CLI that turns any MCP server, OpenAPI spec or GraphQL endpoint into commands at runtime, with no codegen
A local MCP gateway: set servers up once and use them in Claude Code, Codex, Cursor and other agents, with keys in the OS keychain
An MCP server that lets Claude Code, Codex and other agents call Gemini, GPT, Grok and local models for review, debugging and consensus
AgentBridge by Graphene Lab
AgentBridge Graphene Lab
The standalone AgentBridge server exposes over MCP one office agent with Word, Excel, email and a task scheduler
A single Rust gateway between an agent and all its MCP servers: the client sees 9 to 17 meta-tools and finds the rest on demand.
A plugin that gives an agent the IntelliNode skill and MCP server: ask any model, search, review code, tests, SQL, images and speech
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| SandBase CLI (this card) | yes | OAuth | 186 | |
| Claude Code Router | no | 38,127 | a local gateway that picks the model provider for Claude Code and other agents; SandBase CLI connects a catalog of models and APIs as MCP tools with a shared balance | |
| Agentgateway | yes | OAuth | 6,144 | a proxy for agent traffic that you deploy yourself; SandBase CLI calls a hosted catalog and configures the clients itself |
README in short
The README starts with a one-line install for an agent and step-by-step guides for Hermes and OpenClaw. Then come a price table, the command list and security, and it ends with links to the directories that already list the project.