> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zap.wzrd.tech/llms.txt
> Use this file to discover all available pages before exploring further.
# Use Zap from your agent
> One command connects any coding agent to Zap over MCP. Pick your agent, paste the snippet, done.
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:
```bash theme={null}
npx -y @wzrdtech/zap@5.0.1 mcp
```
No MCP support? Paste these URLs into your agent chat instead:
```text theme={null}
https://zap.wzrd.tech/llms.txt
https://docs.zap.wzrd.tech
```
## Connect your agent
```bash theme={null}
claude mcp add zap -- npx -y @wzrdtech/zap@5.0.1 mcp
```
Or add to `.mcp.json` in your project root:
```json .mcp.json theme={null}
{
"mcpServers": {
"zap": {
"command": "npx",
"args": ["-y", "@wzrdtech/zap@5.0.1", "mcp"]
}
}
}
```
Add to `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global):
```json .cursor/mcp.json theme={null}
{
"mcpServers": {
"zap": {
"command": "npx",
"args": ["-y", "@wzrdtech/zap@5.0.1", "mcp"]
}
}
}
```
```bash theme={null}
codex mcp add zap -- npx -y @wzrdtech/zap@5.0.1 mcp
```
Or add to `~/.codex/config.toml`:
```toml ~/.codex/config.toml theme={null}
[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:
```bash theme={null}
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:
```bash theme={null}
npx @wzrdtech/zap@5.0.1 compose --weight heavy --harness hermes --json
```
See [zap-heavy-hermes](/harnesses/hermes) for ports, templates, and overlays.
OpenClaw is a Zap harness — compose it and the Zap MCP server is pre-registered:
```bash theme={null}
npx @wzrdtech/zap@5.0.1 compose --weight heavy --harness openclaw --json
```
See [zap-heavy-openclaw](/harnesses/openclaw) for ports, templates, and overlays.
Add to Pi's MCP config (`~/.pi/mcp.json`):
```json ~/.pi/mcp.json theme={null}
{
"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:
```bash theme={null}
zap mcp --http --host 127.0.0.1 --port 3910
```
Non-loopback binds require `ZAP_MCP_TOKEN`. See [MCP](/mcp) for tool domains and transport details.
## What your agent can do
Resolve `Runtime.md` into a deterministic plugin tree with a lock hash.
Render, deploy, and drive durable sessions — plan-only by default.
Exec CPU work on Box VMs and every other provider behind one contract.
Every tool returns structured JSON with stable error codes.