Webhooks

Sends HTTP requests to webhooks using dynamic parameters with validation, logging, and configurable timeouts.

typescript

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "rafabarbosa-webhook_mcp": {
      "command": "node",
      "args": [
        "/Users/rafabarbosa/Desktop/scripts/webhooks-mcp/dist/index.js"
      ],
      "env": {
        "LANG": "en",
        "LOG_LEVEL": "info",
        "RETRY_ATTEMPTS": "1",
        "WHITELIST_URLS": "api.example.com,https://hooks.example.org",
        "RETRY_BASE_DELAY_MS": "500"
      }
    }
  }
}

This Webhooks MCP server lets you send HTTP requests to webhooks with dynamic parameters, supporting all HTTP methods, custom headers, configurable timeouts, and robust input validation. It is designed to integrate with an MCP client so you can trigger webhook calls from your automation workflows and apps with ease.

How to use

You can trigger webhook calls from your MCP client by specifying the target URL, HTTP method, optional parameters, and optional headers. The server handles parameter typing, serializes the request body for methods like POST/PUT/PATCH, and embeds query parameters for GET/DELETE when needed. It also logs requests and responses so you can verify behavior and diagnose issues.

To run the MCP locally, use the standard stdio approach shown below. This starts the local MCP server process which you then interact with from your MCP client.

{
  "mcpServers": {
    "webhooks": {
      "command": "node",
      "args": ["/Users/rafabarbosa/Desktop/scripts/webhooks-mcp/dist/index.js"]
    }
  }
}

How to install

Prerequisites you need installed on your machine before running the MCP server: Node.js and npm are required to build and run the server. You should also have a shell to execute the commands.

Step by step install and build flow:

# Change to the project directory
cd webhooks-mcp

# Install dependencies
npm install

# Compile TypeScript to JavaScript
npm run build

Configuration and usage notes

Configure your environment and runtime behavior using environment variables. The MCP supports a whitelist for allowed webhook destinations, log verbosity levels, automatic retry behavior, and language localization.

The following environment variables are commonly used by the Webhooks MCP server:

export WHITELIST_URLS="api.exemplo.com,https://hooks.slack.com"
export LOG_LEVEL="debug"
export RETRY_ATTEMPTS=3
export RETRY_BASE_DELAY_MS=1000
export LANG=en

Claude Desktop configuration

Add the following MCP server configuration in your Claude Desktop setup to run the local Webhooks MCP server.

{
  "mcpServers": {
    "webhooks": {
      "command": "node",
      "args": ["/Users/rafabarbosa/Desktop/scripts/webhooks-mcp/dist/index.js"]
    }
  }
}

Usage example: send_webhook tool

Use the available tool to send a webhook request with a set of parameters, headers, and a timeout as needed. You can target any webhook URL and choose the HTTP method that fits your integration.

Available tools

send_webhook

Sends an HTTP request to a webhook with customized parameters, supporting various HTTP methods, optional headers, and a configurable timeout.

Built by

VeilStrat

AI signals for GTM teams