MCP Server (WIP)
Roadmap status for Model Context Protocol integration.
Overview
Trellis has MCP (Model Context Protocol) support in the codebase, but the standalone CLI entry point is not shipped yet. Do not use trellis mcp; the current CLI will report it as an unknown command.
Current Supported Path
trellis code --web --mcp-port 3333
This launches the OpenCode harness and starts MCP in the managed web mode used by the harness. A standalone trellis mcp command and published MCP configuration are tracked on the roadmap.
Planned Tools
| Tool | Purpose |
|---|---|
trellis_status | Branch, op count, tracked files, recent ops |
trellis_log | Op history with optional filters |
trellis_files | List all tracked files |
trellis_branch | List / create / switch / delete branches |
trellis_milestone | List or create milestones |
trellis_diff | File-level diff between op hashes |
trellis_garden | List / search / stats / revive idea clusters |
trellis_parse | Parse TS/JS content into AST entities |
trellis_semantic_diff | Semantic diff between file versions |
trellis_init | Initialize a new repository |
trellis_issue_create | Create issue with metadata and criteria |
trellis_issue_list | List/filter issues |
trellis_issue_start | Start issue (auto-branch, auto-assign) |
trellis_issue_pause | Pause issue |
trellis_issue_resume | Resume issue |
trellis_issue_triage | Move issue backlog → queue |
trellis_issue_update | Update issue metadata |
trellis_issue_check | Run acceptance criteria |
trellis_issue_close | Close issue |
trellis_decision_list | List/filter decision traces |
trellis_decision_show | Show full decision trace |
trellis_decision_chain | Trace decisions affecting an entity |
Configuration
Standalone .mcp.json configuration is WIP because there is no shipped trellis mcp command yet.