@requestbin/mcp-server

Use RequestBin directly in Claude Code, Cursor, Windsurf, and any MCP-compatible AI coding agent.

Create webhook bins, inspect captured HTTP requests, and replay them — all without leaving your editor.

Installation

npm install -g @requestbin/mcp-server

Or run directly with npx:

npx @requestbin/mcp-server

Get an API Key

1. Go to requestbin.net/api-keys
2. Create a new API key
3. Requires a PRO ($12/mo) or TEAM ($29/mo) plan

Configuration

Claude Code

Add to your project's .mcp.json or ~/.claude/settings.json:

{
  "mcpServers": {
    "requestbin": {
      "command": "requestbin-mcp",
      "env": {
        "REQUESTBIN_API_KEY": "rb_your_key_here"
      }
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "requestbin": {
      "command": "requestbin-mcp",
      "env": {
        "REQUESTBIN_API_KEY": "rb_your_key_here"
      }
    }
  }
}

Cursor

Add to Cursor Settings > MCP Servers:

{
  "requestbin": {
    "command": "requestbin-mcp",
    "env": {
      "REQUESTBIN_API_KEY": "rb_your_key_here"
    }
  }
}

Windsurf

Add to ~/.windsurf/mcp_config.json:

{
  "mcpServers": {
    "requestbin": {
      "command": "requestbin-mcp",
      "env": {
        "REQUESTBIN_API_KEY": "rb_your_key_here"
      }
    }
  }
}

Available Tools

Tool	Description
list_bins	List all your webhook bins with URLs and stats
create_bin	Create a new webhook bin (returns URL for webhook endpoint)
get_bin	Get bin details including recent interactions
delete_bin	Delete a webhook bin
list_interactions	List captured HTTP requests for a bin (method, headers, body)
replay_request	Send an HTTP request to any URL (server-side replay)
get_replay_status	Check the status of a replay job
list_servers	List available servers for bin creation

Example Workflow

Here is what a typical conversation looks like with an AI agent that has the RequestBin MCP server configured:

You: "Create a webhook bin for testing my Stripe integration"

The agent will:

1. Call list_servers to find available servers
2. Call create_bin with name "Stripe Webhooks"
3. Return the bin URL to configure in your Stripe Dashboard

You: "Show me the last 5 requests to my Stripe webhook bin"

The agent will:

1. Call list_bins to find your bins
2. Call list_interactions with the bin ID and limit of 5
3. Display the HTTP method, path, headers, and body of each captured request

You: "Replay the last webhook event to my local server at localhost:3000/webhooks"

The agent will:

1. Call list_interactions to find the most recent request
2. Call replay_request with the same method, headers, and body targeting http://localhost:3000/webhooks
3. Call get_replay_status to confirm delivery

Environment Variables

Variable	Required	Default	Description
REQUESTBIN_API_KEY	Yes	--	Your API key from requestbin.net/api-keys
REQUESTBIN_BASE_URL	No	https://requestbin.net	Custom API base URL (for self-hosted instances)

Requirements

• Node.js >= 18
• RequestBin PRO ($12/mo) or TEAM ($29/mo) plan for API key access
• Free tier available at requestbin.net for basic webhook capture (no API/MCP access)

Development

cd packages/mcp-server
npm install
npm run dev    # runs with tsx (hot reload)
npm run build  # compile TypeScript to dist/

License

MIT