Grok Bot harness: BrainstormRouter as the Bot's control plane

2026-08-26

mcp-servercapability-graphroutingmemory

What We Built

A Cursor / Grok Bot plugin that treats BrainstormRouter as the Bot's harness, not a bolted-on MCP server. Cursor already has @anysphere/grok-bot-harness for coding agents. This package is the BR equivalent: always-on rules, MCP at POST /v1/mcp/connect, skills for route/memory/capabilities/cost/compare, and specialist agents (orchestrator, router, memory, ops).

Install locally with bash plugins/grok-bot/scripts/install-local.sh, or import the GitHub repo as a Cursor team marketplace (.cursor-plugin/marketplace.json).

Why It Matters

Grok Bot without this plugin will use Grok's own models and forget tenant facts when the chat ends. With it, generation goes through model=auto (capability-matched routing), memory is the BR 4-block store, spend is budget-gated, and the Bot is told to query GET /v1/capabilities instead of grepping.

How It Works

Grok Bot loads Cursor marketplace plugins (github / url / local path). The plugin's mcp.json sends Authorization: Bearer ${BRAINSTORMROUTER_API_KEY} to the existing Streamable HTTP MCP endpoint. rules/br-harness.mdc is alwaysApply: true, so every Bot on the account inherits the control-plane behavior after the operator pastes a key.

No new API routes. Existing MCP + capability graph do the work.

The Numbers

1 plugin, 5 skills, 4 specialist agents, 1 always-on rule
MCP surface unchanged (116 tools)
Smoke: unit test asserts production MCP URL is /v1/mcp/connect not /v1/mcp/sse

Competitive Edge

OpenRouter/Portkey plugins would expose a proxy. This harness forces auto routing, memory writes, feedback into Thompson sampling, and capability-graph queries — BR's actual product, not a format converter.

Lockstep Checklist

[x] API Routes: no route changes.
[x] TS SDK: n/a
[x] Python SDK: n/a
[x] MCP Schemas: existing tools only; plugin consumes them.
[x] Master Record: Grok Bot harness row on CAF/substrate table.
[x] Docs: docs/guides/grok-bot.mdx + Framework Guides nav.
[x] MNI: llms.txt, API llms.txt duplicate, agents.json, .well-known/grok-bot-plugin.json, playbook.