# Scout

> Scout is an open-source MCP server for developer tools. Local runtime for routing work between Claude Code, Codex, Cursor and other coding agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux
- **Website:** https://openscout.app/docs/integrations
- **Repository:** https://github.com/openscout-app/scout/tree/HEAD/packages/cli
- **MCP Registry name:** io.github.openscout-app/scout
- **Categories:** developer tools, AI models and LLM tooling
- **Listing updated:** 2026-11-15

## About

Scout keeps agents' own processes and transcripts and layers a record of requests, replies and handles on top. The README's first handoff shows `scout ask --project . --harness codex`, which returns a ref handle; `scout status` and `scout wait` follow it, a timeout does not cancel the work, and a finished task can seed a successor with `--continue`.

The package supports harnesses for Claude Code, Codex, Cursor, OpenCode, Kimi, Grok, Pi and Devin. Local use needs Bun 1.4.4 or newer on Apple-silicon macOS or Linux, plus an authenticated harness. The docs list integrations for Claude Code, Codex, Cursor, Hermes, pi, Slack and the hosted Grok Bot, and clarify which are execution harnesses and which are only hosts.

The MCP server connects agent hosts to the local runtime; Scout Chat can join an invited room without it.

## Features

- **Task handoff:** Ask another coding agent to review or do work and get a ref handle.
- **Status and wait:** Follow progress; a wait timeout does not cancel.
- **Successor tasks:** Continue from a finished request in a fresh session.
- **Many harnesses:** Claude Code, Codex, Cursor, OpenCode, Kimi, Grok, Pi, Devin.
- **Host integrations:** Plugins for Claude Code, Codex, Cursor and Hermes.
- **Scout Chat:** Join invited rooms with Node.js or Bun.

## Good for

- Ask Codex to review a Claude Code change
- Track long-running agent work by handle
- Route work to the right harness for a project
- Coordinate agents from Cursor through MCP

## Install

### Claude Code (Terminal)

```sh
claude mcp add scout -- npx -y @openscout/scout
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "scout": {
      "command": "npx",
      "args": [
        "-y",
        "@openscout/scout"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "scout": {
      "command": "npx",
      "args": [
        "-y",
        "@openscout/scout"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "scout": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@openscout/scout"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "scout": {
      "command": "npx",
      "args": [
        "-y",
        "@openscout/scout"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "scout": {
      "command": "npx",
      "args": [
        "-y",
        "@openscout/scout"
      ]
    }
  }
}
```

## FAQ

### What do I need to install it?

Bun 1.4.4 or newer, Apple-silicon macOS or Linux, and an authenticated coding agent.

### Does installing start services?

No; scout setup starts the runtime on macOS, and Linux needs a foreground runtime.

### Which agents does it route to?

Claude Code, Codex, Cursor, OpenCode, Kimi, Grok, Pi and Devin.

### Does Scout replace the agents' transcripts?

No. The harnesses keep their processes and transcripts.

### Is Scout free?

Yes. Scout is open source, so you can use and self-host it for free.

### How do I add Scout to Claude Code?

Run this command in your terminal: claude mcp add scout -- npx -y @openscout/scout

### What are the best alternatives to Scout?

The closest alternatives to Scout are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/scout-5
