Optibot code reviews in any AI-powered editor.

Point your editor at the server

No install step is needed. The configuration below launches the server with npx, which fetches it on demand and picks up each new release. To try it from a terminal first:

npx -y @optimalai/optibot-mcp

Requires Node.js 22 or later. On an older version the server fails at runtime.

Add to your MCP client configuration

Add the following configuration block to your MCP client's config file. The config is the same JSON for Claude Desktop, Cursor, and Windsurf — only the file path differs. For Claude Code, use the CLI command instead.

{
  "mcpServers": {
    "optibot": {
      "command": "npx",
      "args": ["-y", "@optimalai/optibot-mcp"],
      "env": {
        "OPTIBOT_API_KEY": "optk_your_key_here"
      }
    }
  }
}

Config file locations

• Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
• Cursor: .cursor/mcp.json in your project root
• Windsurf: ~/.codeium/windsurf/mcp_config.json
• Claude Code: claude mcp add optibot -e OPTIBOT_API_KEY=optk_your_key_here -- npx -y @optimalai/optibot-mcp

Generate and set your API key

Generate an Optibot API key from your dashboard at agents.getoptimal.ai, or create one directly via the CLI:

optibot setup ci

That command belongs to the Optibot CLI, which also runs reviews in CI. Replace optk_your_key_here in your config with the generated key. To run reviews in a pipeline, store the key as a secret in your CI provider and pass it to the CLI as the OPTIBOT_API_KEY environment variable.

Alternatively, authenticate via browser: use the login tool inside your MCP client to authenticate interactively — this saves a 90-day token to ~/.optibot/config.json.

Ask for a review in natural language

Once configured, ask your AI assistant naturally:

• "review my changes" — reviews all uncommitted local changes
• "review my branch against main" — full branch diff against main
• "review this diff file" — reviews an arbitrary .patch or .diff file
• "check if I'm authenticated" — confirms your auth status
• "create an API key for CI" — generates a new API key

The MCP server handles the rest — connecting to Optibot, running the review, and streaming real-time progress back to your client.