MCP Servers

The Model Context Protocol (MCP) lets P31 connect to external tools and data sources. Currently two MCP servers are bundled.

PHOS Forge

Command: node /path/to/phos-forge/mcp-server.mjs

26 tools for file management, cognitive state, deployment, research, and self-healing:

• phos-adopt Classify and move unclassified files to canonical locations
• phos-status Show manifest stats, recent activity, unclassified files
• phos-classify Classify a single file, show canonical destination
• phos-learn Infer a draft canonical map by scanning project structure
• phos-rollback Roll back the last N file moves
• phos-watch Start background file watcher (vibe mode)
• phos-deploy Deploy Cloudflare Pages/Worker with spoon-aware gating
• cognitive-state Get current cognitive state (5-dimensional vector)
• cognitive-estimate Run fresh estimate cycle, return updated state
• healer-remediate Run self-healer remediation cycle
• healer-log Show recent self-healer activity
• jitterbug-run Fractal research workflow — split, research, converge, repeat
• phos-aura Render terminal particle visualization of cognitive state
• reflex-status Show Reflex Arc status, pattern cooldowns, recent firings
• tide-status Tide temporal pattern learning model
• kappa-status Kappa outcome-aware weights
• cartographer-query Semantic codebase search via TF-IDF
• cartographer-trace Find all files referencing a symbol
• cartographer-related Find semantically related files
• logbook-status Session memory state
• logbook-today Today's auto-generated session log
• brain-dump Process quantum brain dump — parse, elaborate, research
• brain-status Recent brain dump sessions
• brain-diff Compare two brain dump sessions
• bus-emit Emit event to PHOS Forge event bus
• yardmaster-inspect Inspect yardmaster daemon status

Google Workspace

Command: node /path/to/google-workspace-mcp/build/index.js

Calendar, contacts, and email integration. Enables queries like "What meetings do I have today?"

Adding Custom MCP Servers

MCP servers are configured in cmd/chat.go in the initMCP() function:

servers := []p31mcp.ServerDef{
  {
    Name:    "my-server",
    Command: "node",
    Args:    []string{"/path/to/server.mjs"},
    Env:     map[string]string{"KEY": "value"},
  },
}

Tool names are prefixed with server__ (e.g., my-server__my-tool) to route calls to the correct server.