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

# Model Context Protocol (MCP)

> Equip Claude Desktop, Cursor, and Windsurf with email tools in 30 seconds.

## Overview

The **Model Context Protocol (MCP)** is an open standard that enables autonomous LLMs to securely execute client-side and cloud tools.

`gork-mcp` connects any MCP-compliant agent directly to your gork.email workspace over `stdio`.

## Exposed Tools

When connected, your agent automatically gains 4 tools:

1. `gork_create_inbox`: Provision a new agent email address on demand.
2. `gork_send_email`: Send an outbound email with subject, text/html, and attachments.
3. `gork_read_emails`: Query incoming messages with automatic threading.
4. `gork_reply_email`: Reply to an existing email thread.

## Configuration

### Claude Desktop

Add the following to your `claude_desktop_config.json`:

* **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

```json theme={null}
{
  "mcpServers": {
    "gork": {
      "command": "npx",
      "args": ["-y", "gork-mcp", "--api-key=gork_live_YOUR_KEY"]
    }
  }
}
```

### Cursor & Windsurf

Add to `~/.cursor/mcp.json`:

```json theme={null}
{
  "mcpServers": {
    "gork": {
      "command": "npx",
      "args": ["-y", "gork-mcp", "--api-key=gork_live_YOUR_KEY"]
    }
  }
}
```

### Claude Code CLI

Run directly in your terminal:

```bash theme={null}
claude mcp add gork npx -y gork-mcp --api-key=gork_live_YOUR_KEY
```