📡 Gotrasoft Webhook

The Missing Link for AI Agents: Real-Time Webhook Reception.

Just as Humans use phones to receive calls, AI Agents need a way to receive incoming signals from the outside world. Gotrasoft Webhook provides your AI with a persistent, public URL that can accept data from Stripe, GitHub, Twilio, Zapier, or any custom API—instantly.

Powered by a robust Remote Relay architecture, this Model Context Protocol (MCP) server allows your local AI (running on Claude Desktop, VS Code, or Cursor) to "listen" for events without needing complex tunneling like ngrok.

✨ Key Features

• 🌐 Instant Public URLs: Generate a live https://mcp-server.gotrasoft.com endpoint in one click. No DNS configuration required.
• 🛡️ Robust Polling:
  • Auto-Retry: Built-in resilience against network flakes using system-level fallbacks (Axios + Curl).
  • Anti-Blocking: Masquerades as a standard browser to bypass WAFs and bot filters.
  • Cache-Busting: Guarantees you never read stale data.
• ⚡ Zero-Latency Feel: High-frequency polling (1s) ensures your Agent reacts to data the moment it hits the server.
• 🧹 Auto-Cleanup: "Read-once, Destroy-immediately" architecture ensures data privacy. Once your Agent consumes an event, it is wiped from the relay server.

📦 Installation

Global Installation (Recommended)

Make it available everywhere on your system:

npm install -g gotrasoft-webhook

Run via npx

Run it on-demand without installing:

npx -y gotrasoft-webhook

🛠️ Setup & Configuration

Integrate Gotrasoft Webhook into your favorite AI tools.

🧩 VS Code (MCP Extension)

Add this to your MCP configuration:

{
  "mcpServers": {
    "webhook": {
      "command": "npx",
      "args": [
        "-y",
        "gotrasoft-webhook"
      ]
    }
  }
}

🤖 Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "webhook": {
      "command": "npx",
      "args": [
        "-y",
        "gotrasoft-webhook"
      ]
    }
  }
}

💡 Usage Examples

This server provides two essential tools to your Agent:

1. create_webhook_session

Ask your agent: "Create a webhook URL for me."

Output:

{
  "session_id": "1a4f49a7...",
  "webhook_url": "https://mcp-server.gotrasoft.com/relay.php?webhook_id=1a4f49a7..."
}

Your Agent now has a URL to give to Stripe/GitHub/etc.

2. wait_for_webhook

Ask your agent: "Wait for data on this session."

The Agent will pause and listen. The moment data arrives at the URL, the tool returns the full JSON payload.

Authentication Note: The URLs are public but obscure (GUID-based). Security relies on the secrecy of the URL. Use for development and rapid prototyping workflows.

🏗️ Architecture

1. Remote Relay: A high-performance PHP script hosted on mcp-server.gotrasoft.com capable of handling thousands of concurrent writes.
2. Local Client: This Node.js MCP server running on your machine, which polls the Relay securely.
3. Fallback System (v1.4): If standard HTTP requests fail (e.g. strict corporate firewalls), the client automatically spawns a system curl process to guarantee connectivity.

🔗 Explore the Ecosystem

Build a complete development toolkit for your AI Agents with our other MCP servers:

📮 Gotrasoft Postman

The Ultimate API Tester. Execute complex HTTP requests (GET, POST, PUT, DELETE) with full Auth support (Bearer, Basic, API Key). Perfect for testing the webhooks you just received!

🐬 Gotrasoft MySQL

Safe Database Exploration. Inspect schemas and run safe queries on your databases.

📄 License

MIT © I Komang Gede Yuliana

Built with ❤️ by Gotrasoft for the AI native future.