MCP overview
Flock exposes stigmergy and harness tools via flock mcp (stdio CLI) and live episodes (flock run --mcp).
Start the server
flock mcp
Wire your MCP client to stdin/stdout JSON-RPC (same surface as cargo run -p flock-mcp).
Quick tool list
| Tool | Description |
|---|---|
flock_discover_tools | Browse tool domains |
flock_search_tools | Keyword search |
flock_describe_tool | Full schema for one tool |
flock_deposit_signal | Deposit stigmergic signal |
flock_read_blackboard | Read blackboard slot |
flock_topology_snapshot | Harness topology JSON |
flock_multiplexer_status | Dashboard statusline |
flock_propose_mutation | Topology mutation (governed) |
Full catalog with live-column and governance notes: MCP tools.
Operational tools in LIVE_TOOL_NAMES are available on flock run --mcp (see crates/flock-runtime/src/mcp/registry.rs).
Live episode example
{
"mcp_tools": [
{
"tool": "flock_deposit_signal",
"args": { "zone": "grid", "signal": "coordination", "amount": 2.0 }
}
]
}
Governance pre/post hooks apply on the MCP hot path when --mcp is set.
Editor integration
- Cursor setup — wire MCP in Cursor settings
- Agent guide — onboarding for Claude/Codex/Cursor/Pi