# Sandbaseai Cli

> Agent-first CLI and MCP bridge for 2,000+ AI models, multimodal generation, sandboxes, and agent workflows—one command, one account.

- **Type:** MCP server
- **Install:** `agentstack add mcp-sandbaseai-cli`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [sandbaseai](https://agentstack.voostack.com/s/sandbaseai)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [sandbaseai](https://github.com/sandbaseai)
- **Source:** https://github.com/sandbaseai/cli
- **Website:** https://www.sandbase.ai

## Install

```sh
agentstack add mcp-sandbaseai-cli
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

@sandbaseai/cli
  
    Give your AI agent superpowers. One command. 2,000+ AI models.
  
  
    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 through the [Model Context Protocol](https://modelcontextprotocol.io). No API keys to manage. No configuration headaches.

```sh
npx -y @sandbaseai/cli connect
```

That's it. Your agent now has access to everything.

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

---

## See It In Action

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

### "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

| 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 (17+)

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 @sandbaseai/cli catalog --json
```

```sh
# Connect all detected clients at once
npx -y @sandbaseai/cli connect

# Or target one specific client
npx -y @sandbaseai/cli 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

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

### MCP Tools (available to your agent after connecting)

| Tool | Purpose |
|------|---------|
| `sandbase_discover` | Search all 2,000+ available AI models |
| `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) |

**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](https://sandbase.ai/console/keys)

---

## Get Started

```sh
npx -y @sandbaseai/cli connect
```

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

**[Create a free account →](https://sandbase.ai)**

If SandBase saves you setup time, [star the repository](https://github.com/sandbaseai/cli) — it helps more agent users discover the project.

---

## Links

- [SandBase Platform](https://sandbase.ai)
- [Documentation](https://docs.sandbase.ai)
- [npm Package](https://www.npmjs.com/package/@sandbaseai/cli)
- [Dashboard](https://sandbase.ai/console)

## License

Apache-2.0

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [sandbaseai](https://github.com/sandbaseai)
- **Source:** [sandbaseai/cli](https://github.com/sandbaseai/cli)
- **License:** Apache-2.0
- **Homepage:** https://www.sandbase.ai

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-sandbaseai-cli
- Seller: https://agentstack.voostack.com/s/sandbaseai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.