Skip to main content
Opencode MCP docs You can find your API key at ref.tools/keys

​
Install Steps

  1. Create or update an opencode.jsonc file in your project:
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "RefPlan": {
      "type": "remote",
      "url": "https://api.plan.ref.tools/mcp",
      "enabled": true,
      "headers": {
        "x-ref-api-key": "YOUR_API_KEY"
      }
    }
  }
}
For plan-specific mode, use "url": "https://api.plan.ref.tools/mcp?plan=<PLAN_ID>".

​
Verify

Open a new chat and ask the agent to list your plans or read a specific plan.

​
Get help

If you have any issues, please reach out to help@ref.tools. We’re happy to help you get started!