MCP Webhook Server

An MCP server implementation that integrates with webhooks, providing message sending capabilities with automatic response handling.

Features

• Generic Webhook Support: Send messages to any webhook endpoint
• Dynamic URLs: Specify webhook URLs directly in your messages
• Automatic Response Handling: Automatically waits for and returns webhook responses
• Custom Username: Set custom display name for messages
• Avatar Support: Customize message avatar
• MCP Integration: Works with Claude and other MCP-compatible LLMs
• Response Timeout: Configurable response timeout (default: 5 minutes)

Installation

npm install @abdo-el-mobayad/mcp-webhook

Configuration with Claude

Add this to your MCP configuration:

{
  "mcpServers": {
    "webhook": {
      "command": "npx",
      "args": [
        "-y",
        "@abdo-el-mobayad/mcp-webhook"
      ],
      "alwaysAllow": [
        "send_message"
      ]
    }
  }
}

Tool Documentation

• send_message
  • Send message to a webhook endpoint and wait for response
  • Inputs:
    • url (string, required): The webhook URL to send the message to
    • content (string, required): Message content to send
    • username (string, optional): Display name
    • avatar_url (string, optional): Avatar URL
  • Returns:
    • Message confirmation and webhook response data
  • Response Format:

    Message sent successfully.
    Status: COMPLETED
    Response: {
      // Your webhook response data here
    }

Usage Examples

Ask your LLM to:

"Send a message to https://your-webhook.com: Hello World!"
"Send to https://discord.webhook.url: content='Testing', username='Bot'"

The response will be returned automatically - no need to ask for it separately!

Manual Start

If needed, start the server manually:

npx @abdo-el-mobayad/mcp-webhook

Requirements

• Node.js 18+
• MCP-compatible LLM service

Response Handling

The server automatically handles webhook responses:

• Waits up to 5 minutes for a response
• Returns both send confirmation and response data
• Includes response status and full response body
• Handles timeouts and errors gracefully

Response statuses:

• COMPLETED: Successfully received response
• FAILED: Error occurred
• TIMEOUT: No response within timeout period

License

MIT

Author

Abdo El Mobayad

Repository

GitHub Repository

Keywords

• mcp
• webhook
• chat
• claude
• llm
• automation