bazaar-mcp

@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

• When you call a paid tool without a payment token, you'll get a detailed 402 response showing the price and payment options
• Payment is supported on Base (standard) and SKALE Europa (gasless, sub-second)
• 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