# bazaar-mcp-server

**Repository Path**: uesoft/bazaar-mcp-server

## Basic Information

- **Project Name**: bazaar-mcp-server
- **Description**: No description available
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-25
- **Last Updated**: 2026-02-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# @opspawn/bazaar-mcp

MCP server for the [x402 Bazaar](https://a2a.opspawn.com) — 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

```bash
npm install -g @opspawn/bazaar-mcp
```

Or use directly with npx:

```bash
npx @opspawn/bazaar-mcp
```

## Configuration

### Claude Code

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

```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:

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

### Cline

Add to your Cline MCP settings:

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

### SSE Transport (Remote/Web Clients)

Start the server in SSE mode:

```bash
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](https://www.x402.org/) 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

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

## License

MIT