dump-mcp

MCP (Model Context Protocol) server for dump.xoozoo.com - a webhook capture and inspection service.

This server allows AI assistants like Claude to create webhook endpoints, view captured requests, and replay them to local development servers.

Features

• Endpoint Management: Create, list, and delete webhook capture endpoints
• Request Viewing: List and inspect captured webhook requests with full headers and body
• Request Replay: Replay captured requests to target URLs with optional modifications

Installation

npm install -g dump-mcp

Or use directly with npx (no install needed):

npx dump-mcp

Configuration

1. Create an Agent Token

1. Log in to dump.xoozoo.com
2. Click your avatar → Agent Tokens
3. Create a new token and copy it (you'll only see it once)

2. Configure Your MCP Client

Claude Desktop

Add to your Claude Desktop config file:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "dump": {
      "command": "npx",
      "args": ["-y", "dump-mcp"],
      "env": {
        "DUMP_API_TOKEN": "dmp_your_token_here"
      }
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "dump": {
      "command": "dump-mcp",
      "env": {
        "DUMP_API_TOKEN": "dmp_your_token_here"
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | DUMP_API_TOKEN | Yes | Your agent token from dump.xoozoo.com | | DUMP_API_URL | No | API URL (default: https://dump.xoozoo.com) |

Available Tools

Endpoint Management

| Tool | Description | |------|-------------| | dump_list_teams | List your teams | | dump_list_endpoints | List endpoints in a team | | dump_create_endpoint | Create a new webhook capture endpoint | | dump_get_endpoint | Get endpoint details and capture URL | | dump_delete_endpoint | Delete an endpoint |

Request Viewing

| Tool | Description | |------|-------------| | dump_list_requests | List captured requests (with filtering) | | dump_get_request | Get full request details (headers, body) |

Request Replay

| Tool | Description | |------|-------------| | dump_replay_request | Replay a request to a target URL | | dump_get_replay_result | Get the replay response | | dump_list_replays | List recent replays |

Usage Examples

Create a Webhook Endpoint

"Create a new webhook endpoint called github-hooks in my team"

The assistant will:

1. List your teams to find the team ID
2. Create the endpoint
3. Return the capture URL to configure in GitHub

View Captured Requests

"Show me the last 5 requests to my github-hooks endpoint"

The assistant will list recent requests with method, path, and timestamp.

Inspect a Request

"Show me the full details of that POST request"

The assistant will show headers, body, and other details.

Replay to Local Server

"Replay that webhook to http://localhost:3000/webhook"

The assistant will replay the captured request to your local development server and show the response.

Development

# Clone the repo
git clone https://github.com/xoozoo/dump.git
cd dump/dump-mcp

# Install dependencies
npm install

# Build
npm run build

# Run locally
DUMP_API_TOKEN=dmp_xxx node dist/index.js

Security

• Agent tokens have full access to your account's endpoints and requests
• Tokens are hashed before storage; the raw token is only shown once
• Revoke tokens immediately if compromised
• Use separate tokens for different environments

License

MIT