MCP Server

The Dispatch MCP (Model Context Protocol) server lets AI assistants manage your webhooks directly. You can list sources, create destinations, inspect events, and configure filters and transforms through natural language in tools like Claude, Cursor, Windsurf, and other MCP-compatible clients.

Quick Install

Install in Cursor

One command install

For Claude Code, run this in your terminal:

claude mcp add dispatch \
  -e DISPATCH_API_KEY=dsp_your_api_key_here \
  -- npx @dispatch.tech/mcp

Prerequisites

• A Dispatch account with a project
• An API key (created in Project Settings > API Keys)
• Node.js 18 or later

Installation

npm install -g @dispatch.tech/mcp

Or run it directly with npx (no global install needed):

npx @dispatch.tech/mcp

Configuration

The MCP server requires one environment variable:

Variable	Required	Description
DISPATCH_API_KEY	Yes	Your project API key (starts with dsp_)

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "dispatch": {
      "command": "npx",
      "args": ["@dispatch.tech/mcp"],
      "env": {
        "DISPATCH_API_KEY": "dsp_your_api_key_here"
      }
    }
  }
}

Claude Code

claude mcp add dispatch \
  -e DISPATCH_API_KEY=dsp_your_api_key_here \
  -- npx @dispatch.tech/mcp

Cursor

Click here to install in Cursor, or manually add to .cursor/mcp.json:

{
  "mcpServers": {
    "dispatch": {
      "command": "npx",
      "args": ["@dispatch.tech/mcp"],
      "env": {
        "DISPATCH_API_KEY": "dsp_your_api_key_here"
      }
    }
  }
}

Windsurf

Add to .windsurf/mcp.json:

{
  "mcpServers": {
    "dispatch": {
      "command": "npx",
      "args": ["@dispatch.tech/mcp"],
      "env": {
        "DISPATCH_API_KEY": "dsp_your_api_key_here"
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "dispatch": {
      "command": "npx",
      "args": ["@dispatch.tech/mcp"],
      "env": {
        "DISPATCH_API_KEY": "dsp_your_api_key_here"
      }
    }
  }
}

Available Tools

Sources

Tool	Description
list_sources	List all webhook sources (endpoints) in the project
create_source	Create a new webhook source
get_source	Get details of a specific source
update_source	Update a source's name, active status, provider, signing secret, or event types
delete_source	Delete a source and all its connections

Destinations

Tool	Description
list_destinations	List all destinations in the project
create_destination	Create a new webhook destination
get_destination	Get details of a specific destination
delete_destination	Delete a destination and all its connections

Connections

Tool	Description
list_connections	List connections for a source
create_connection	Connect a source to a destination
delete_connection	Remove a connection between a source and destination

Events

Tool	Description
list_events	List recent webhook events with pagination and filtering
get_event	Get full event details including delivery attempts

Templates

Tool	Description
list_templates	List all message templates
create_template	Create a message template for formatting payloads

Transforms

Tool	Description
list_transforms	List all JSONata transforms
create_transform	Create a JSONata transform expression

Filters

Tool	Description
list_filters	List filter groups for a source
create_filter	Create a filter group with conditions
delete_filter	Delete a filter group

Example Usage

Once configured, you can interact with Dispatch through your AI assistant:

• "List all my webhook sources"
• "Create a new source called Stripe"
• "Show me the last 10 events"
• "Connect my GitHub source to my Discord destination"
• "Create a filter on my GitHub source to only accept push events to main"
• "What events came in today?"

Generating an API Key

1. Open the Dispatch dashboard
2. Navigate to your project's Settings page
3. Click API Keys > Create Key
4. Copy the key (it starts with dsp_ and is only shown once)
5. Use this key as the DISPATCH_API_KEY environment variable