MCP overview
Castellan exposes stigmergy and harness tools via castellan mcp (stdio CLI) and live episodes (castellan run --mcp).
Start the server
castellan mcp
Wire your MCP client to stdin/stdout JSON-RPC (same surface as cargo run -p castellan-mcp).
Quick tool list
| Tool | Description |
|---|---|
castellan_discover_tools | Browse tool domains |
castellan_search_tools | Keyword search |
castellan_describe_tool | Full schema for one tool |
castellan_deposit_signal | Deposit stigmergic signal |
castellan_read_blackboard | Read blackboard slot |
castellan_topology_snapshot | Harness topology JSON |
castellan_multiplexer_status | Dashboard statusline |
castellan_propose_mutation | Topology mutation (governed) |
Full catalog with live-column and governance notes: MCP tools.
Operational tools in LIVE_TOOL_NAMES are available on castellan run --mcp (see crates/castellan-runtime/src/mcp/registry.rs).
Live episode example
{
"mcp_tools": [
{
"tool": "castellan_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