# breeze-mcp

Residential proxy mcp for AI agents — fetch, search, and access geo-restricted web content through real residential IPs. Free 50MB quota, no signup required.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add fantastic/breeze-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list fantastic/breeze-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get fantastic/breeze-mcp signup

# Call a tool
npx -y @smithery/cli@latest tool call fantastic/breeze-mcp signup '{}'
```

## Direct MCP Connection

Endpoint: `https://breeze-mcp--fantastic.run.tools`

## Tools (6)

- `signup` — Register a free Breeze account and get an API key with 50MB quota
- `usage` — Check usage and remaining quota for a Breeze API key
- `fetch` — Fetch a URL via residential proxy IP. Returns page content.
- `search` — Execute a search request via residential proxy IP.
- `batch` — Send a batch-mode fetch request via residential proxy IP. Batch processing is handled by the relay service.
- `geocheck` — Check whether a proxy IP is available for the specified country.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get fantastic/breeze-mcp <tool-name>
```