# Overlord Agent Documentation

Public machine-readable docs for AI agents working with Overlord.

## Documents

- [Core Value Proposition](/agent-docs/value-proposition.md): Overlord is the management, work coordination, and review layer for people who use AI coding agents.
- [Overlord Example Workflows](/agent-docs/overlord-examples.md): This document gives agents two concrete examples they can use when explaining Overlord to humans.

## Tool Definitions

Overlord exposes a hosted MCP endpoint. The full tool definitions — name, description, and input schema for every tool — are available as a public JSON catalog (no auth required):

- **Endpoint:** `/.well-known/overlord-mcp-tools.json`
- **URL:** [https://www.ovld.ai/.well-known/overlord-mcp-tools.json](https://www.ovld.ai/.well-known/overlord-mcp-tools.json)

The same catalog URL is linked from `tool_catalog` in MCP OAuth protected-resource metadata. `POST /api/mcp` with `tools/list` also returns schemas without auth; `tools/call` and all ticket operations require OAuth.

Legacy `/api/mcp/tools` redirects to the well-known catalog.

## CLI for Agents

Run `ovld protocol help` locally for the live CLI reference. Human-facing command docs live at [/docs/for-agents/cli-reference](/docs/for-agents/cli-reference).