SandBase

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 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.

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

For a reproducible install, verify the immutable release archive before running it. The SHA-256 for sandbaseai-cli-0.1.17.tgz is 1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa.

curl -fL -o sandbaseai-cli-0.1.17.tgz \
  https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz
echo '1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa  sandbaseai-cli-0.1.17.tgz' | shasum -a 256 -c -
npx -y ./sandbaseai-cli-0.1.17.tgz connect

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:

npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz 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.

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, TensorBlock MCP Index, MCPRepository, MCP Server Hub, MCP Server Spot, or the Awesome AI API Proxy. 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.

Related MCP server: ai-mcp-server

See It In Action

After connecting, just ask your agent naturally. It handles the rest.

The outputs below are illustrative examples of the interaction pattern. Live results, latency, availability, and pricing vary by provider and request; use sandbase_inspect before running a model or API to see its current schema and price.

"Search the web for React 19 new features"

Agent → SandBase Web Search → 10 results in 0.8s
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. "React 19 is Here: What's New" — react.dev
2. "React 19 Compiler Deep Dive" — Dan Abramov's blog
3. "Migrating to React 19" — Vercel Engineering
...

"Get trending posts about AI on Twitter"

Agent → SandBase Twitter API → Top 10 posts
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. @karpathy: "LLMs are the new CPUs..." (45K ❤️)
2. @emollick: "Agent benchmarks just crossed..." (12K ❤️)
3. @swyx: "The MCP ecosystem is growing fast..." (8K ❤️)
...

"Generate a minimalist logo for my startup 'NightOwl'"

Agent → SandBase Flux Image Gen → 1024x1024 PNG
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✓ Generated: nightowl-logo.png
  Style: Minimalist, dark theme
  Cost: $0.003
  Time: 2.1s

"Scrape the pricing table from linear.app"

Agent → SandBase Firecrawl Scraper → Structured data
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✓ Extracted 3 plans:
  Free: $0/mo — Up to 250 issues
  Standard: $8/user/mo — Unlimited issues + cycles
  Plus: $14/user/mo — Advanced features + analytics

"Use GPT-4o to review this pull request for issues"

Agent → SandBase GPT-4o → Analysis complete
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Found 2 issues:
  ⚠️  Race condition in useEffect (line 42)
  ⚠️  Missing error boundary around async component
  ✓  Type safety looks good
  ✓  Test coverage adequate

"Create a 5-second product demo video"

Agent → SandBase Kling Video Gen → Async processing
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⏳ Generating... (45s)
✓ Output: product-demo.mp4 (5s, 720p)
  Cost: $0.10

What's Inside

Supported Clients (25 Targets)

Works with every major AI coding tool:

Preview the complete compatibility catalog without signing in or changing any files:

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

# 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

How It Works

┌─────────────────┐         ┌───────────────┐         ┌────────────────────┐
│   Your Agent    │  MCP    │  Local Bridge │  HTTPS  │    SandBase API     │
│  (Cursor, etc.) │────────▶│  (on-demand)  │────────▶│  2,000+ AI models  │
│                 │◀────────│               │◀────────│                    │
└─────────────────┘         └───────────────┘         └────────────────────┘

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

sandbase connect [--client <name>]    # Authorize + configure
sandbase doctor [--client <name>]     # Health check
sandbase unregister [--client <name>] # Remove configuration
sandbase catalog --json               # List all supported clients

MCP Tools (available to your agent after connecting)

Workflow your agent follows automatically:

discover → inspect → run

1. sandbase_discover(q: "twitter search")        → finds matching tools
2. sandbase_inspect(name: "twitter_timeline")    → gets schema + pricing
3. sandbase_run(name: "twitter_timeline", ...)   → executes and returns data

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

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

Then ask your agent to do something it couldn't before.

Create a free account →

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 · 中文

• 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:

• Awesome MCP

• Awesome AI API Proxy

• Awesome Gemini CLI

• Hermes Atlas

• Awesome Hermes Agent

• Awesome AI Tools

• Awesome MCP Server

License

Apache-2.0