# MCP & Skills

This page combines the key resources for AI-assisted Hookdeck workflows: the Hookdeck MCP server, Hookdeck skills, and AI-ready docs access patterns.

## Hookdeck MCP

The Hookdeck CLI runs an [MCP](https://modelcontextprotocol.io/) (Model Context Protocol) server: `hookdeck gateway mcp`.

Use it when you want an AI assistant (Cursor, Claude, etc.) to query and inspect Hookdeck data in-session: connections, events, requests, issues, and metrics.

### What this MCP does

* Exposes Hookdeck resources as MCP tools over stdio (the client starts the CLI process and communicates on stdin/stdout).
* Supports authenticated read and inspection workflows across Event Gateway resources.
* Registers a `hookdeck_login` tool when needed so authentication can happen without leaving the MCP session.

### Prerequisites

* Install the Hookdeck CLI and make sure `hookdeck` is on your `PATH`.
* Authenticate with `hookdeck login` or provide `HOOKDECK_API_KEY` in your MCP client env.

### MCP client configuration

Configure your client to launch the CLI command over stdio:

```json
{
  "mcpServers": {
    "hookdeck-gateway": {
      "command": "hookdeck",
      "args": ["gateway", "mcp"],
      "env": {}
    }
  }
}

```

You can also pass CLI flags in `args` (for example `--hookdeck-config`, `--profile`, `--log-level`).

For full command behavior, tools, troubleshooting, and examples, see the [CLI MCP command reference](/docs/cli#mcp).

### Commonly used tools

| Tool | Purpose |
| --- | --- |
| `hookdeck_projects` | List projects or switch active project |
| `hookdeck_connections` | Inspect, pause, and unpause connections |
| `hookdeck_sources` / `hookdeck_destinations` | Inspect inbound sources and outbound destinations |
| `hookdeck_requests` / `hookdeck_events` / `hookdeck_attempts` | Trace flow from request to delivery attempts |
| `hookdeck_issues` / `hookdeck_metrics` | Investigate failures and query aggregate metrics |
| `hookdeck_help` | Discover available tools and usage |

### When to use MCP vs skills

| Goal | Use |
| --- | --- |
| Query and inspect Hookdeck resources and metrics | Hookdeck MCP (`hookdeck gateway mcp`) |
| Create or change resources (connections, sources, retries, transformations) | Hookdeck Agent Skills |

## Hookdeck Product Skills {#hookdeck-product-skills}

Install all product skills:

* Event Gateway (`--skill event-gateway`): Build and operate Event Gateway configurations with guided CLI/API workflows.
  
  
* Outpost (`--skill outpost`): Guidance for sending webhooks with Outpost.
  
  

Repository: [github.com/hookdeck/agent-skills](https://github.com/hookdeck/agent-skills)

## Webhook Skills

Install all provider webhook skills:

Install specific providers:

* Stripe: 
* Shopify: 
* GitHub: 
* OpenAI: 
* Resend: 
* Paddle: 

Repository: [github.com/hookdeck/webhook-skills](https://github.com/hookdeck/webhook-skills)

## AI agent resources

* Docs index for LLMs: https://hookdeck.com/docs/llms.txt
* Markdown access: append `.md` to any docs URL, or use page actions (Copy as Markdown / View as Markdown).
* CLI reference: see [CLI docs](/docs/cli), including [`listen`](/docs/cli#listen) for local development workflows.
* Detailed MCP docs: see [CLI MCP command reference](/docs/cli#mcp) for transport, auth, full tool list, and troubleshooting.