# Model Context Protocol (/mcp)

The **Model Context Protocol (MCP)** lets AI assistants call **CaptureKit** as **tools**: same operations as the REST API, with your **API key**.

## What you need [#what-you-need]

- An account on **CaptureKit** ([register](https://app.capturekit.dev/register) if needed) and access to the [dashboard](https://app.capturekit.dev).
- An **API key** with the **`x-api-key`** header (see [API Keys](/api-keys)).
- **MCP endpoint:** **`https://mcp.capturekit.dev/`**

## How it works [#how-it-works]

The server uses **Streamable HTTP** at **`https://mcp.capturekit.dev/`**. It is not a normal web page. Each **tool** maps to an API operation; billing and behaviour match the REST API. Use the rest of this documentation for endpoints and parameters.

## Claude Code [#claude-code]

Official docs: [Model Context Protocol (MCP)](https://code.claude.com/docs/en/mcp). Example: **`claude mcp add --transport http capturekit https://mcp.capturekit.dev/`** with **`--header`** **`x-api-key: YOUR_API_KEY`**. Use the same URL as in the Cursor section below.

## Cursor [#cursor]

See the [Cursor MCP documentation](https://cursor.com/docs/mcp). In **Settings → MCP**, add an **HTTP** server, or use a project **`mcp.json`** with a **`url`** (ending in `/`) and **`headers`** for your API key.

Use the **MCP endpoint** for **CaptureKit** below. Never commit secrets. Prefer environment-specific config or a placeholder like `YOUR_API_KEY`.

```json
{
  "mcpServers": {
    "capturekit": {
      "url": "https://mcp.capturekit.dev/",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}
```

## Gemini CLI [#gemini-cli]

See [MCP server](https://geminicli.com/docs/tools/mcp-server/) in the Gemini CLI documentation. Point the client at **`https://mcp.capturekit.dev/`** and pass your API key (for example via **`x-api-key`**) as the tool docs describe.

## OpenAI Developer Mode [#openai-developer-mode]

See [Developer mode](https://developers.openai.com/api/docs/guides/developer-mode) in the OpenAI API documentation. Wire MCP tools to **`https://mcp.capturekit.dev/`** and your **API key** following that guide.

## See also [#see-also]

- [API Keys](/api-keys): create and manage keys
- [Best practices](/best-practices): secure integration

## Package and source code [#package-and-source-code]

- npm: [`@capturekitdev/mcp`](https://www.npmjs.com/package/@capturekitdev/mcp)
- MCP Registry: [`dev.capturekit/mcp`](https://registry.modelcontextprotocol.io/v0/servers?search=dev.capturekit/mcp)
- GitHub: [github.com/capturekitdev/capturekit-mcp](https://github.com/capturekitdev/capturekit-mcp)