sena-labs/oz-mcp-server

What is OzBridge?
**OzBridge is an open-source Model Context Protocol
(MCP) server and VS Code extension that runs Warp Oz cloud and local agents from any
MCP-compatible client — GitHub Copilot Chat, Claude Code, Cursor and Codex CLI.**
> **Independent extension** — not affiliated with, endorsed by, or sponsored by Warp, Inc.
> **Warp™** and **Oz™** are trademarks of Warp, Inc., used here nominatively only to
> describe interoperability. OzBridge uses solely Warp's **documented public interfaces**
> (the oz CLI, the Model Context Protocol, and the WARP_OUTPUT_FORMAT env var); it does
> not modify, reverse-engineer, or compete with Warp. See DISCLAIMER.
Run it embedded in VS Code — where Oz shows up natively as the @oz **Chat
Participant** and as **Agent-Native Language Model Tools** that Copilot Agent
mode invokes autonomously — or expose the same Oz toolset over HTTP+SSE so
**Claude Code, Cursor and Codex** drive Oz too. No editor at all? Ship the
standalone @sena-labs/oz-mcp-server and point any
MCP client at it.
Feature gallery
Runs & Resources
Warp Drive
MCP bridge
Dashboard
---
Table of Contents
- Features
- Requirements
- Installation
- Connect your MCP client
- How do I use Warp Oz in Claude Code?
- How do I use Warp Oz in Cursor?
- How do I use Warp Oz in Codex CLI?
- How do I use Warp Oz in VS Code?
- Usage
- Chat Participant (@oz)
- Slash Commands
- Agent Mode — Language Model Tools
- Tools
- Configuration
- Architecture
- Development
- Contributing
- Troubleshooting
- FAQ
- License
> **New to Warp or to VS Code extensions?** The
> Quick Start guide is a
> step-by-step visual walkthrough — prerequisites, per-OS install, first run,
> every slash command, settings and troubleshooting — written for readers with
> no prior setup. Full documentation site: .
---
Features
- **MCP bridge — Warp Oz for any client** — expose the Oz toolset as a Model Context Protocol server over HTTP+SSE so **Claude Code, Cursor and Codex** drive Oz through the same tools Copilot sees. Run it embedded in VS Code (opt-in) or fully standalone via @sena-labs/oz-mcp-server. See docs/MCP.md.
- **@oz Chat Participant** — interact with Warp Oz agents from the VS Code chat panel.
- **Agent-Native Language Model Tools** — Copilot Agent mode can invoke Warp Oz directly, without typing @oz.
- **One-click model selection** — pick the Oz model from a QuickPick (OzBridge: Select Model), the $(sparkle) status-bar indicator, or @oz /models — no hand-typing an id into settings. Agents switch it via the MCP tools oz_list_models / oz_set_default_model.
- **Warp sidebar + status bar** — Activity Bar view with Active Runs, History, Schedules, Environments, MCP Servers and Secrets, plus a $(cloud) Warp: N active indicator and a $(sparkle) model indicator (click to switch).
- **Context variables & Warp handoff** — inline #warp.env, #warp.profile, #warp.model, #oz.history and #oz.run/ tokens expanded into any /run or /cloud prompt, plus a one-click handoff to an actual Warp terminal.
- **Per-workspace config** — optional .warp/warp-bridge.yaml committed to the repo overrides ozBridge.* settings for everyone who opens the project. Precedence: YAML > VS Code settings > defaults. Secrets like mcpBearerToken and platform-specific ozPath are deliberately excluded.
- **9 slash commands** covering the full agent workflow: /run, /cloud, /status, /history, /schedule, /models, /mcp, /config, /init.
- **IDE context injection** — automatically includes workspace path, active file, selection and diagnostics in every prompt.
- **Agent skill detection** — maps prompt keywords to the 7-agent pipeline (spec, design, implement, review, test, deploy, maintenance).
- **Cloud run polling** — exponential-backoff polling with real-time progress updates in the chat stream.
- **Robust JSON parser** — 5-level fallback for mixed text/JSON CLI output.
- **Configurable** — every setting is exposed via the VS Code Settings UI under ozBridge.*.
- **Minimal runtime footprint** — one bundled workspace package (copilot-chat-toolkit) plus the vscode API; no third-party network code. Production bundle ~160 KB.
Requirements
- **VS Code** ≥ 1.101.0 (the @oz participant requires the stable Chat Participant API; LM Tools additionally require vscode.lm.registerTool).
- **Warp Terminal** installed, with the oz CLI accessible in PATH.
- A **Warp account**, signed in via oz login.