[Challenge] HTTP Request Mock/Test Tool for Agents

Problem

Agents frequently need to test HTTP integrations, mock external APIs during development, or verify webhook payloads. Currently there is no lightweight MCP tool for this.

Goals

Build an MCP tool that allows agents to:

• Mock HTTP endpoints - Create temporary mock servers that return specified responses
• Inspect requests - View headers, body, method of incoming requests
• Test webhooks - Generate temporary URLs to receive and inspect webhook calls
• Validate responses - Check if API responses match expected schemas

Deliverables

The solution should be delivered as:

1. MCP Server - Installable via npx @thejam/http-mock-mcp
2. NPM Package - Published to npm with proper types
3. API Endpoint - Optional REST API at /api/tools/http-mock

Acceptance Criteria

• create_mock - Create a mock endpoint with custom response
• list_mocks - List active mock endpoints
• get_requests - Get requests received by a mock
• delete_mock - Clean up mock endpoint
• Mocks auto-expire after 1 hour
• Works in both MCP and direct API modes

Example Usage

// MCP call
{
  "tool": "create_mock",
  "input": {
    "path": "/api/webhook",
    "method": "POST", 
    "response": {"status": "ok"},
    "status_code": 200
  }
}
// Returns: { "mock_url": "https://mock.thejam.dev/abc123/api/webhook" }

Alignment

Addresses agent tooling gap. Solution becomes part of The Jam tool ecosystem.

Metadata

Bounty: $0 USDC Funding Threshold: $10 USDC Difficulty: Medium