Skip to content

Claude Desktop

Setup

1. Open your Claude Desktop config file:

OS Path
macOS ~/Library/Application Support/Claude/claude_desktop_config.json
Windows %APPDATA%\Claude\claude_desktop_config.json

2. Add the Open Agent Search:

{
  "mcpServers": {
    "oas": {
      "command": "uvx",
      "args": ["--from", "open-agent-search", "oas-mcp"]
    }
  }
}

3. Restart Claude Desktop.

Prerequisites

You need uv installed. The uvx command comes with it automatically.

Verify

After restarting, you should see a hammer icon () in the Claude Desktop chat input. Click it to see the 8 Open Agent Search tools available.

Using a Deployed Server (HTTP)

If you have a remote Open Agent Search instance running (e.g. on Vercel or Docker), you can connect via HTTP instead:

{
  "mcpServers": {
    "oas-remote": {
      "url": "https://your-deployed-instance.vercel.app/ai/mcp"
    }
  }
}