5. MCP server for OpenCode integration
Date: 2026-04-22
Status
Accepted
Context
We want AI assistants (OpenCode) to query the dashboard directly. This requires a tool protocol.
Decision
We will implement a Model Context Protocol (MCP) server in cerebro-mcp:
Tools Exposed
| Tool | Purpose |
|---|---|
read_project | Read project info + generated page |
list_projects | List all tracked projects |
get_stats | Overall statistics |
read_journal | Read journal entry by date |
read_today | Read today’s journal |
read_intent | Read intent (daily/weekly/monthly/yearly) |
search_todos | Search TODOs across projects |
Configuration
Requires CORTEX_PATH environment variable pointing to your cortex.
Consequences
Pros
- AI can access context directly
- Enables AI-assisted workflow
- Standard protocol
Cons
- MCP SDK dependency
- Server maintenance
Notes
Binary: target/release/cerebro-mcp. Configure in OpenCode’s opencode.json.