Scout for Grok Bot

Bring your local coding agents into a Grok Bot conversation. Scout connects Grok Bot to your OpenScout broker so you can delegate work, exchange messages, and follow results from one chat.

Connection guide · Connect · First ask · OpenScout · All integrations

Connect

MCP URL: https://mcp.oscout.net

1. Open Grok Bot's Plugins settings and add a custom MCP server named OpenScout.

2. Enter the URL above and leave custom headers empty.

3. Sign in with GitHub using the account associated with your Scout bridge.

4. Choose the agent identity that will appear in Scout and approve core tool access.

5. Ask Grok Bot to call Scout's whoami tool and confirm the expected identity.

The connector uses OAuth; no API key needs to be pasted into Grok Bot. The OpenScout publisher application was submitted to Cursor on September 21, 2026 and is awaiting review. Custom MCP setup is available today.

Related MCP server: GrokBot ↔ Hermes Bridge

First ask

From a Grok Bot chat:

Use Scout to ask a Claude agent in /path/to/project to review the latest changes.
Keep the returned work handle for follow-up.

The path refers to your Scout machine. For fresh work, pass projectPath plus optional harness to ask. Let the broker route to a compatible worker. Continue by the returned ref, flight, conversation, work, or session handle; do not guess generic agent names.

Use ask for work that expects a reply. Use messages_send for one-way updates to a known agent or explicit channel. The core MCP tools also expose inbox messages, agent discovery, work updates, and flight inspection.

How it works

Grok Bot → hosted MCP gateway → your online Scout bridge → local broker → coding agents

The gateway supplies the authenticated agent identity. The broker owns the messages and work records. OAuth grants the core mcp:core scope for messaging, asks, and following work. Grok Bot connections are shared across bots on the same Cursor account.

Scout's Grok CLI execution harness is a separate integration. This package lets Grok Bot reach Scout remotely.

Requirements

You need Scout installed on your Mac and at least one coding agent, such as Claude Code or Codex. Connect the Mac to Scout's gateway once with scout mesh bridge connect, and keep it online. Setup takes a few minutes: https://openscout.app/grokbot.

If a call returns node_unreachable, check your machine and run scout mesh bridge status there. Complete bridge provisioning with your Scout operator if no bridge exists.

Marketplace package

The package follows the Grok Bot plugin layout: a hosted MCP connector plus one skill.

• .cursor-plugin/plugin.json: plugin manifest. It lists the connector (mcpServers) and the skill folder (skills), and sets minClientVersions so the plugin installs in Grok Bot 0.49.0 and later.

• mcp.json: hosted MCP server definition using HTTP/OAuth, without embedded credentials.

• skills/scout/SKILL.md: the scout skill. It loads when you mention Scout or /scout, or ask Grok Bot to hand work to Claude or Codex on your Mac. It teaches Grok Bot three ways to reach your agents, in order:

  1. Scout connector connected. Grok Bot checks whoami, hands off work with ask (a full projectPath plus harness), and follows the returned handle with invocations_wait or invocations_get.

  2. Grok Bot Mac app with “Execution on this computer”. Grok Bot runs scout who, scout ask, and scout wait <ref> on your Mac, and sends you to https://openscout.app/grokbot if Scout is not installed.

  3. Grok Bot's own cloud computer. With your okay, Grok Bot installs the remote Scout client, signs in with scout login --as grokbot, sends you the sign-in link, and finishes with the one-time code you paste back.

  It also covers node_unreachable (run scout mesh bridge status, then scout mesh bridge connect, on your Mac) and never asks for tokens in chat.

• assets/logo.svg: Scout mark for the listing.

• docs/index.html: redirect to the canonical guide on openscout.app.

Optional local Cursor setup

The retained .cursor/mcp.json and scripts/install.mjs support local Cursor sessions that launch scout mcp over stdio. These helpers do not configure Grok Bot's hosted connector. For a local Cursor installation only:

bun run install:global -- --dry-run
bun run install:global

Data and support

Tool requests and results pass through Grok Bot, the hosted Scout gateway, and your bridge. They may include messages, project paths, task instructions, and agent output. GitHub sign-in and OAuth grants identify your account and Scout agent. Your local broker stores Scout coordination records.

See the OpenScout privacy policy and your host’s data policy. For setup and support, open an issue without credentials or private task content.

Validate

bun run check

Licensed Apache-2.0; see LICENSE and NOTICE.