Use Zap from your agent

Zap ships an MCP server in the CLI. Any MCP-capable agent gets the full tool surface — recipes, compose, runtime, agents, fs, harness, pay, memory, media, doctor — from one command:

npx -y @wzrdtech/zap@5.0.1 mcp

No MCP support? Paste these URLs into your agent chat instead:

https://zap.wzrd.tech/llms.txt
https://docs.zap.wzrd.tech

Connect your agent

claude mcp add zap -- npx -y @wzrdtech/zap@5.0.1 mcp

Or add to .mcp.json in your project root:

.mcp.json

{
  "mcpServers": {
    "zap": {
      "command": "npx",
      "args": ["-y", "@wzrdtech/zap@5.0.1", "mcp"]
    }
  }
}

Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

.cursor/mcp.json

{
  "mcpServers": {
    "zap": {
      "command": "npx",
      "args": ["-y", "@wzrdtech/zap@5.0.1", "mcp"]
    }
  }
}

codex mcp add zap -- npx -y @wzrdtech/zap@5.0.1 mcp

Or add to ~/.codex/config.toml:

~/.codex/config.toml

[mcp_servers.zap]
command = "npx"
args = ["-y", "@wzrdtech/zap@5.0.1", "mcp"]

Add a custom MCP server in Settings → MCP Marketplace → Add custom server with:

npx -y @wzrdtech/zap@5.0.1 mcp

Or paste https://zap.wzrd.tech/llms.txt into the session chat — Devin reads it directly.

Hermes is a Zap harness — compose it and the Zap MCP server is pre-registered:

npx @wzrdtech/zap@5.0.1 compose --weight heavy --harness hermes --json

See zap-heavy-hermes for ports, templates, and overlays.

OpenClaw is a Zap harness — compose it and the Zap MCP server is pre-registered:

npx @wzrdtech/zap@5.0.1 compose --weight heavy --harness openclaw --json

See zap-heavy-openclaw for ports, templates, and overlays.

Add to Pi’s MCP config (~/.pi/mcp.json):

~/.pi/mcp.json

{
  "mcpServers": {
    "zap": {
      "command": "npx",
      "args": ["-y", "@wzrdtech/zap@5.0.1", "mcp"]
    }
  }
}

Or paste https://zap.wzrd.tech/llms.txt into the chat.

HTTP transport

For remote agents, run Streamable HTTP instead of stdio:

zap mcp --http --host 127.0.0.1 --port 3910

Non-loopback binds require ZAP_MCP_TOKEN. See MCP for tool domains and transport details.

What your agent can do

Compose runtimes

Resolve Runtime.md into a deterministic plugin tree with a lock hash.

Run agents

Render, deploy, and drive durable sessions — plan-only by default.

Drive sandboxes

Exec CPU work on Box VMs and every other provider behind one contract.

Stay machine-readable

Every tool returns structured JSON with stable error codes.

Get Started

Core Concepts

Agents as Code

Runtime Services

Sandboxes

Harnesses & Templates

MCP

Use Zap from your agent

Connect your agent

HTTP transport

What your agent can do

Compose runtimes

Run agents

Drive sandboxes

Stay machine-readable

​Connect your agent

​HTTP transport

​What your agent can do

Compose runtimes

Run agents

Drive sandboxes

Stay machine-readable

Connect your agent

HTTP transport

What your agent can do