Webhook.site FastMCP

A FastMCP-based Model Context Protocol (MCP) server for the Webhook.site API. It exposes the API as MCP tools for creating, reading, updating, and managing webhook tokens and their captured requests.

Prerequisites

• Python 3.12+

• uv (recommended) or pip

Related MCP server: Webhook.site MCP Server

Configuration

Configure the following environment variables to authenticate and set defaults:

Running

Direct execution

uv run server.py

Install editable

You can install this package in editable mode:

uv pip install -e .

This registers the CLI command webhook-mcp.

Claude Desktop example

To use this with Claude Desktop, add the following to your claude_desktop_config.json (usually located at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "webhook-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "$HOME/.agents/Webhook.site-FastMCP",
        "run",
        "server.py"
      ],
      "env": {
        "WEBHOOK_SITE_API_KEY": "your-api-key-here",
        "WEBHOOK_SITE_TOKEN_ID": "your-default-token-id-here"
      }
    }
  }
}

Available tools

1. create_token

Creates a new Webhook.site token (URL / email address container).

• Arguments:

  • api_key (string, optional): Overrides WEBHOOK_SITE_API_KEY.

  • default_status (number, optional): Default HTTP status returned to requests (200-599).

  • default_content (string, optional): Default response body content.

  • default_content_type (string, optional): Default response Content-Type (e.g. application/json, text/html).

  • timeout (number, optional): Seconds to sleep before responding (max 30).

  • listen (number, optional): Seconds to wait for "Set Response" endpoint response.

  • expiry (number, optional): Seconds until the token auto-expires (default: 604800, 1 week).

  • request_limit (number, optional): Limits request history stored (0 to 10000).

  • cors (boolean, optional): If true, adds CORS headers to responses.

  • alias (string, optional): Sets a custom token alias.

  • actions (boolean, optional): Enables/disables Custom Actions.

  • clone_from (string, optional): Token UUID to clone settings from.

2. get_token

Get details and configuration of a Webhook.site token.

• Arguments:

  • token_id (string, optional): Token UUID (defaults to WEBHOOK_SITE_TOKEN_ID).

  • api_key (string, optional): Overrides WEBHOOK_SITE_API_KEY.

3. update_token

Update settings of an existing Webhook.site token.

• Arguments:

  • Same configuration parameters as create_token + token_id.

4. delete_token

Delete the Webhook.site token completely.

• Arguments:

  • token_id (string, optional): Token UUID (defaults to WEBHOOK_SITE_TOKEN_ID).

  • api_key (string, optional): Overrides WEBHOOK_SITE_API_KEY.

5. list_requests

List captured requests, emails, and DNSHooks sent to a token.

• Arguments:

  • token_id (string, optional): Token UUID.

  • api_key (string, optional): Overrides WEBHOOK_SITE_API_KEY.

  • sorting (string, optional): Sorting order, either "newest" or "oldest".

  • per_page (number, optional): Page size (default: 50, max: 100).

  • page (number, optional): Page number to retrieve (default: 1).

  • date_from (string, optional): Filter requests starting from date (yyyy-MM-dd HH:mm:ss).

  • date_to (string, optional): Filter requests ending at date (yyyy-MM-dd HH:mm:ss).

  • query (string, optional): Query string to filter results.

6. get_latest_request

Get the latest raw request body sent to a Webhook.site token.

• Arguments:

  • token_id (string, optional): Token UUID.

  • api_key (string, optional): Overrides WEBHOOK_SITE_API_KEY.

7. delete_requests

Delete all or filtered requests captured by a Webhook.site token.

• Arguments:

  • token_id (string, optional): Token UUID.

  • api_key (string, optional): Overrides WEBHOOK_SITE_API_KEY.

  • date_to (string, optional): Filter to delete requests up to this date.

  • query (string, optional): Filter to delete requests matching this query.

Resources

webhooksite://token/{token_id}/requests

Allows clients to retrieve the complete list of requests captured by the specified token in raw JSON format.