@opspawn/bazaar-mcp

MCP server for the x402 Bazaar — AI-powered tools available via x402 micropayments.

Use screenshots, AI analysis, PDF/HTML generation, code security scanning, and dependency auditing directly from Claude Code, Cursor, Cline, or any MCP client.

Available Tools

| Tool | Description | Cost | |------|-------------|------| | bazaar_screenshot | Capture a screenshot of any URL with AI analysis | $0.01 USDC | | bazaar_ai_analysis | AI-powered page analysis using Gemini 2.0 Flash | $0.01 USDC | | bazaar_md_to_pdf | Convert markdown to a styled PDF document | $0.005 USDC | | bazaar_md_to_html | Convert markdown to styled HTML | $0.005 USDC | | bazaar_code_scan | Scan code for security vulnerabilities | $0.05 USDC | | bazaar_dep_audit | Audit dependencies for known CVEs | $0.10 USDC | | bazaar_test | Free connectivity test | Free | | bazaar_status | List all services and pricing | Free |

Installation

npm install -g @opspawn/bazaar-mcp

Or use directly with npx:

npx @opspawn/bazaar-mcp

Configuration

Claude Code

Add to your Claude Code MCP settings (~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "bazaar": {
      "command": "npx",
      "args": ["@opspawn/bazaar-mcp"],
      "env": {
        "X402_PAYMENT_TOKEN": "your-payment-token-here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "bazaar": {
      "command": "npx",
      "args": ["@opspawn/bazaar-mcp"]
    }
  }
}

Cline

Add to your Cline MCP settings:

{
  "mcpServers": {
    "bazaar": {
      "command": "npx",
      "args": ["@opspawn/bazaar-mcp"]
    }
  }
}

SSE Transport (Remote/Web Clients)

Start the server in SSE mode:

npx @opspawn/bazaar-mcp --sse

Connect your MCP client to http://localhost:3402/sse.

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | X402_PAYMENT_TOKEN | Payment signature for paid endpoints | (empty — will get 402 responses) | | A2A_GATEWAY_URL | x402 Bazaar gateway URL | https://a2a.opspawn.com | | REQUEST_TIMEOUT | Request timeout in milliseconds | 30000 | | SSE_PORT | Port for SSE transport mode | 3402 |

Payment Setup

x402 Bazaar endpoints use the x402 protocol for micropayments in USDC.

How it works

1. When you call a paid tool without a payment token, you'll get a detailed 402 response showing the price and payment options
2. Payment is supported on Base (standard) and SKALE Europa (gasless, sub-second)
3. To make paid requests, set the X402_PAYMENT_TOKEN environment variable with a valid x402 payment signature

Supported networks

• Base (eip155:8453) — USDC, standard gas fees
• SKALE Europa (eip155:2046399126) — USDC, zero gas fees, sub-second finality
• Arbitrum One (eip155:42161) — USDC, standard gas fees

Development

git clone https://github.com/opspawn/bazaar-mcp-server.git
cd bazaar-mcp-server
npm install
npm run build
npm test

License

MIT