> ## Documentation Index
> Fetch the complete documentation index at: https://askeditor.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart: Agents (MCP)

> Connect any MCP client to AskEditor in one config block.

The fastest integration is no integration: AskEditor ships a hosted MCP
connector. Point your agent at it and the whole catalog becomes callable.

## Connect

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={null}
    claude mcp add askeditor --transport http https://mcp.askeditor.com
    ```
  </Tab>

  <Tab title="claude.ai / Desktop">
    Settings → Connectors → **Add custom connector** →
    `https://mcp.askeditor.com` → **Authorize**.
  </Tab>

  <Tab title="Cursor / other MCP clients">
    Add a custom MCP server with URL `https://mcp.askeditor.com`
    (Streamable HTTP). Complete the OAuth prompt when asked.
  </Tab>
</Tabs>

Authorization uses your AskEditor account via OAuth: no key handling.

## First job, in plain language

Once connected, this is a conversation, not code:

> "List the AskEditor templates." → the agent calls `list_recipes`
>
> "Tighten this recording: \~/Desktop/take-3.mp4" → the agent uploads the
> file, gets a free estimate (price + any blockers), asks you to confirm,
> runs the job, and returns **two links**: the finished mp4 and the
> editable canvas.

## What the agent sees

Every job resolves to the same envelope:

```json theme={null}
{
  "status": "completed",
  "finalUrl": "https://…/cut.mp4",
  "canvasId": "66f…",
  "canvasUrl": "https://askeditor.com/…/editor?canvas=66f…"
}
```

<Note>
  Refusals are typed and free: if the material can't carry the template
  (silent recording, no visible subject, too long), the agent gets a
  machine-readable reason before anything is charged. See
  [Refusals](/docs/setting-up/refusals).
</Note>