Skip to main content
Warp OZ integration lets you launch Warp OZ agents directly from your plans and track their progress.

​
Install the Ref MCP server in Warp OZ

Give Warp OZ access to your plans and tasks by connecting the Ref Plans MCP server with the streamable HTTP endpoint https://api.plan.ref.tools/mcp. Full steps for installing the MCP server, including API key setup, are in the Ref Plans MCP install guide. This will allow Warp OZ agents to send messages back to a Ref agent orchestrator.

​
Connect Warp OZ

  1. Go to Settings in Ref Plans
  2. Click the Agent Settings tab
  3. Select the Warp OZ tab
  4. Paste your Warp API key
  5. Optionally enter an Environment ID
Warp API keys start with wk-.... In the Warp desktop app, open Settings > Platform and create an API key. Most users with a single environment can leave Environment ID blank.

​
Launch an agent

  1. Open your plan and select a task
  2. Click Launch Agent and choose Warp OZ
  3. Review the prompt — Ref pre-populates it with the task details
  4. Click Launch

​
Status tracking

Ref tracks the Warp OZ agent status:
  • Working — The agent is actively implementing the task
  • Finished — The agent has completed its work
  • PR Created — A pull request URL is shown when the agent creates one
You can monitor agent progress directly from your plan without switching to Warp.

​
Get help

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