<!-- canonical: https://capturecat.so/agents -->

# Agents & MCP

CaptureCat ships a Model Context Protocol (MCP) server inside the app — no
plugin, no sidecar. `CaptureCat --mcp` speaks MCP over stdio. Tell Claude,
ChatGPT, Cursor, Copilot, or Windsurf to add zooms where you clicked, restyle a
project, and export the final video.

## Tools

- `list_projects` — every recording in your library.
- `describe_project` — the full timeline plus an interaction digest (click
  clusters and idle spans) so the agent knows where zooms belong.
- `add_effect` — add zoom, tilt, or zoom-tilt effects to a time range.
- `set_style` — change wallpaper, padding, shadows, and other validated
  settings.
- `export_project` — render the final video with the real export engine.

## Install

The server is the app binary itself. Install CaptureCat, then register it:

```sh
# Claude Code
claude mcp add capturecat -- /Applications/CaptureCat.app/Contents/MacOS/CaptureCat --mcp

# OpenAI Codex
codex mcp add capturecat -- /Applications/CaptureCat.app/Contents/MacOS/CaptureCat --mcp
```

For Claude Desktop, Cursor, GitHub Copilot, and Windsurf, add a `capturecat`
entry to the client's MCP config pointing `command` at the binary with
`args: ["--mcp"]`. Full snippets are on the [Agents page](https://capturecat.so/agents).