sandbaseai

cli: Connect AI Agents to SandBase Models and APIs

SandBase CLI uses the Model Context Protocol (MCP) to connect 25 AI clients to SandBase’s models and APIs through a local bridge. It suits developers who want agents such as Claude Code, Cursor, and Codex to access these capabilities without managing API keys.

NewTypeScriptApache-2.0CLIMCPAI Agents
Stars
185
Forks
16
Stars, last 17 days
-4
Last commit
5 days ago
Contributors
2

Our take

Newless than six months old and changing fast

Health score

52/100

How it is scored
Activity
78
Community
36
Issues
21
Pull requests
74

-4 stars in the last 17 days

  • Merges more pull requests than 76% of the projects we track
  • Fewer contributors than 86% of the projects we track

This is a fast-changing, actively released integration layer for teams willing to depend on the SandBase platform and a young project with concentrated contributor activity.

Good fit if

  • You use one of the documented clients and want a local MCP bridge to SandBase’s models and APIs.
  • You value inspecting schemas and current prices before execution, and the browser-based account connection fits your workflow.
  • You can run Node.js 20 or later and are comfortable with a project whose recent contributions come mostly from one of its two contributors.

Look elsewhere if

  • You need a self-hosted model and API backend rather than a bridge to the SandBase service.
  • You require broader contributor ownership or a longer operating history before adopting an integration tool.
  • You need all model calls to be free. The README states that model calls can be paid, even though data APIs are free.
All health signals
Last commit2026-10-12 (5 days ago)
Commits, last 90 days100+
Releases, last 12 months16 (latest v0.3.6, 2026-10-12)
Contributors2 (top contributor: 59% of commits)
Issues closed, last 90 days0
Pull requests merged, last 90 days51 (typically merged in 0 days)
Project age4 months

Checked on 2026-10-18 with the GitHub API.

Overview

SandBase CLI is a TypeScript command-line tool built around the Model Context Protocol (MCP) and the SandBase platform. It connects supported AI clients to SandBase’s catalog of models and APIs through a local bridge, addressing the setup work involved in wiring individual services into an agent.

The project describes support for 25 client targets, including Claude Code, Cursor, Codex, ChatGPT, Hermes, and OpenClaw. A browser-based authorization flow supplies credentials, and the CLI can configure detected clients. Data APIs are free according to the README; model calls may be paid.

Key Features

  • Runs an on-demand local MCP bridge that forwards agent requests to SandBase over HTTPS.
  • Provides discovery and inspection tools to check available endpoints, input schemas, and current prices before running them.
  • Supports model and API calls, including asynchronous jobs that can be polled or resumed.
  • Offers CLI commands for connection, client configuration, diagnostics, catalog inspection, and unregistering managed configuration.
  • Uses browser authorization with PKCE and stores credentials with restricted file permissions.
  • Preserves user-managed client configuration and supports removing only configuration owned by SandBase.
  • Includes a shell-based command workflow for agents that cannot use MCP.

Use Cases

  • A developer using Claude Code, Cursor, or Codex wants to add web search or other data APIs without configuring each provider separately.
  • An agent workflow needs to inspect endpoint schemas and current pricing before a user approves a model call.
  • A team wants one MCP connection available across several supported coding assistants and agent clients.
  • An agent without a working MCP session needs to discover and run SandBase endpoints through shell commands.

What you need

Detected in the repository

  • Node.js >=20 (from package.json)
  • A test suite and automated checks on GitHub Actions

License in plain words

Apache-2.0permissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the license, the NOTICE file and a note of your changes
  • Share your changes: no
  • Includes an explicit patent grant from the contributors:

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

npx -y @sandbaseai/cli@latest connect

Approve the browser authorization, then start a new client session so its MCP tools load. See the README for client-specific setup, commands, and security details.

Alternatives

  • claude-code-proxy: Routes Anthropic-compatible clients to OpenAI, Gemini, or Anthropic backends, while cli connects many AI clients to SandBase models and APIs.
ProjectLanguageLicenseStarsStatus
cliTypeScriptApache-2.0185New
claude-code-proxyPython–3.8kQuiet

Considerations

The project is new and changing quickly, so compatibility and behavior may evolve. It has recent commits and releases, but activity is concentrated: most contributions come from one of its two contributors. No issues were closed during the measured 90-day period, so the available data does not establish a track record for issue resolution. The bridge also depends on an authenticated SandBase account and access to the SandBase API; model calls may incur charges. Node.js 20 or later is required.

Found this useful?

Share it with someone who would like cli.

Comparisons