SandBase CLI: one local MCP bridge for 25 AI client targets

[denial123789]

SandBase CLI is a lightweight, open-source onboarding tool and local MCP bridge for people who use more than one AI coding client. It configures 25 client targets—including Codex, Claude Code, Cursor, Gemini CLI, Windsurf, OpenCode, Warp, Kiro, Hermes, and OpenClaw—to reach one catalog of 2,000+ AI models and APIs.

The bridge exposes six progressively disclosed MCP tools:

• sandbase_discover — search the catalog by intent
• sandbase_inspect — read the current input schema and pricing before execution
• sandbase_run — execute a synchronous or asynchronous request
• sandbase_run_get — poll an asynchronous result
• sandbase_runs — inspect recent calls and costs
• sandbase_account — check account state

The normal agent path is discover → inspect → run, so a client does not have to load thousands of schemas into context or guess request parameters.

Security and lifecycle behavior were the main engineering focus: OAuth device flow with PKCE, credentials stored with restricted file permissions, no secrets in command-line arguments or URLs, ownership-aware config updates, preservation of unrelated JSONC/TOML/YAML content, and exact rollback or unregister of SandBase-owned entries. The repository test suite exercises the supported client adapters and failure compensation paths.

The published Registry entry is io.github.sandbaseai/cli@0.1.17:
https://registry.modelcontextprotocol.io/v0.1/servers/io.github.sandbaseai%2Fcli/versions/0.1.17

Try the pinned release without relying on the older npm latest tag:

npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json

npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect

Source (Apache-2.0): https://github.com/sandbaseai/cli
Install guide: https://github.com/sandbaseai/cli/blob/main/llms-install.md

This is the lightweight bridge companion to SandBase Harness rather than a second agent runtime. Feedback on client lifecycle handling, progressive tool discovery, and Registry metadata is welcome. If it saves you from maintaining another client-specific MCP setup, a GitHub star helps other builders find it.

[denial123789]

Added a reproducible, inspect-before-run walkthrough for Claude Code and Codex: discovery, schema/pricing inspection, execution, async polling, and recent-cost review across the six SandBase MCP tools. It also documents the safety boundaries for billable calls and external writes: sandbaseai/cli#47

[denial123789]

Project update from the SandBase maintainers: the official SandBase CLI project page is now live at https://sandbaseai.github.io/cli/.

It provides a compact overview of the six-tool MCP workflow, the verified 25-client scope, the 2,000+ model/API catalog, the immutable v0.1.17 install command, and links back to this Registry showcase and the canonical io.github.sandbaseai/cli@0.1.17 entry. The page also publishes robots.txt, sitemap.xml, and llms.txt for easier discovery.

Disclosure: I am affiliated with SandBase. AI assistance was used to prepare this update.