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 (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:

{
  "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.

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

Install all product skills:

npx skills add hookdeck/agent-skills Copied

• Event Gateway (--skill event-gateway): Build and operate Event Gateway configurations with guided CLI/API workflows. npx skills add hookdeck/agent-skills --skill event-gateway Copied
• Outpost (--skill outpost): Guidance for sending webhooks with Outpost. npx skills add hookdeck/agent-skills --skill outpost Copied

Repository: github.com/hookdeck/agent-skills

Webhook Skills

Install all provider webhook skills:

npx skills add hookdeck/webhook-skills Copied

Install specific providers:

• Stripe: npx skills add hookdeck/webhook-skills --skill stripe-webhooks Copied
• Shopify: npx skills add hookdeck/webhook-skills --skill shopify-webhooks Copied
• GitHub: npx skills add hookdeck/webhook-skills --skill github-webhooks Copied
• OpenAI: npx skills add hookdeck/webhook-skills --skill openai-webhooks Copied
• Resend: npx skills add hookdeck/webhook-skills --skill resend-webhooks Copied
• Paddle: npx skills add hookdeck/webhook-skills --skill paddle-webhooks Copied

Repository: 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, including listen for local development workflows.
• Detailed MCP docs: see CLI MCP command reference for transport, auth, full tool list, and troubleshooting.