Local MCP server
The smarts CLI includes a local MCP server over stdio. Clients that can launch a local process — Claude Desktop, Claude Code, Cursor, Windsurf, and the Gemini CLI — spawn it as a subprocess. It reuses your CLI credentials, so there's no extra login.
1. Install & log in
Install the CLI and authenticate once:
brew install smartsbio/tap/smarts smarts login
2. Register it with your client
The CLI can write the right config for you:
smarts mcp install claude # Claude Desktop smarts mcp install claude-code # Claude Code smarts mcp install cursor # Cursor smarts mcp install windsurf # Windsurf smarts mcp install gemini # Gemini CLI
Then restart the client. smarts.bio appears as an MCP server with all of its tools.
Manual configuration
Prefer to edit the config yourself? Add this to your client's MCP config (for Claude Desktop, claude_desktop_config.json):
{
"mcpServers": {
"smarts": {
"command": "smarts",
"args": ["mcp", "serve"]
}
}
}Run it directly
You can also start the server by hand to test it:
smarts mcp serveWant to use smarts.bio from ChatGPT, Claude on the web, or Gemini? Those can't spawn a local process — use the hosted MCP server instead.