Skip to main content

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 serve

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