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. hookdeck outpost mcp is a second server for managed Outpost projects.

Use the Event Gateway server when you want an AI assistant (Cursor, Claude, etc.) to query Hookdeck data in-session: connections, events, requests, issues, and metrics. The server starts read-only.

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": {}
    }
  }
}

Add "--allow-write" to args to register tools that create, change, or delete data. Pause and unpause stay available without it. You can also pass other CLI flags (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_read / hookdeck_projects_use	List projects or switch the active project
gateway_connections_read	List and get connections
gateway_connections_pause	Pause and unpause connections
gateway_connections_write	Create, update, and delete connections
gateway_sources_read / gateway_destinations_read	Inspect sources and destinations
gateway_requests_read / gateway_events_read / gateway_attempts_read	Trace a request through to delivery attempts
gateway_issues_read / gateway_metrics_read	Investigate failures and query aggregate metrics
gateway_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 MCP with --allow-write, or Hookdeck Agent Skills for a guided CLI/API workflow

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.
• How agents actually do: AI agent evals is a continuously-run benchmark of coding agents building with and operating Hookdeck, scored against a real project. It measures the CLI, the API and the skills; the MCP server is not one of its published rows.