---
title: "oz0 mcp"
description: "Serve the operators' MCP server on stdin and stdout, as an MCP client starts a local server: `claude mcp add orchestrator-zero -- oz0 mcp`."
canonical_url: "https://docs.oz0.ai/reference/cli/oz0/mcp"
---
# oz0 mcp

> Serve the operators' MCP server on stdin and stdout, as an MCP client starts a local server: `claude mcp add orchestrator-zero -- oz0 mcp`.

For: Operators and developers looking up a command.

Serve the operators' MCP server on stdin and stdout, as an MCP client starts a local server: `claude mcp add orchestrator-zero -- oz0 mcp`.

Each request goes to the management port's MCP endpoint (https://\<management>/admin/mcp) with the CLI context's operator certificate, so the tools act as that operator, with the same rights as the CLI: read nodes, jobs and why they wait, plugins, rollouts, costs, quotas, the audit log and findings; block and unblock nodes, cancel and retry jobs, start and roll back rollouts, decide approvals and set kill switches.

Destructive tools ask the person to confirm when the client can (elicitation), and need "confirm": true otherwise. Every call is in the audit log with via: mcp. Logs go to stderr.

## Usage

```bash
oz0 mcp [flags]
oz0 mcp [command]
```

## Subcommands

- [`clients`](https://docs.oz0.ai/reference/cli/oz0/mcp/clients)

## Flags

<table>
<thead>
  <tr>
    <th>
      Flag
    </th>
    
    <th>
      Type
    </th>
    
    <th>
      Default
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        --url
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <code>
        the context's management address and /admin/mcp
      </code>
    </td>
    
    <td>
      the MCP endpoint
    </td>
  </tr>
</tbody>
</table>

## Inherited flags

<table>
<thead>
  <tr>
    <th>
      Flag
    </th>
    
    <th>
      Type
    </th>
    
    <th>
      Default
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        --context
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <code>
        $OZ0_CONTEXT or &lt;config dir>/orchestrator-zero/context.json
      </code>
    </td>
    
    <td>
      CLI context file written by server init
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --log-level
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <code>
        info
      </code>
    </td>
    
    <td>
      log level: debug, info, warn or error
    </td>
  </tr>
</tbody>
</table>

See [all `oz0` commands](https://docs.oz0.ai/reference/cli/oz0) and the [global flags](https://docs.oz0.ai/reference/cli/oz0#global-flags).


## Sitemap

See the full [sitemap](https://docs.oz0.ai/sitemap.md) for all pages.