Skip to content
MCP server

Scout

Local runtime for routing work between Claude Code, Codex, Cursor and other coding agents

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.5.1
Listing updated
2 days ago

About Scout

Scout is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "scout": {
      "command": "npx",
      "args": [
        "-y",
        "@openscout/scout"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "scout": {
      "command": "npx",
      "args": [
        "-y",
        "@openscout/scout"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

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

Pricing

Open source

Free npm package; public repository

Prices change. Check openscout.app before you buy.

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 to Scout

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools