# SotaProxy MCP Server

**Buy and manage proxies from Claude, Cursor, or any AI agent — in plain language.**

[SotaProxy](https://sotaproxy.com) ships a hosted [Model Context Protocol](https://modelcontextprotocol.io) server. Connect it to your AI assistant and just ask:

> *"Buy me 5 US ISP proxies for a month"*
> *"Get 3 GB of residential traffic and create an endpoint with Austria geo, sticky sessions"*
> *"Give me one residential login I can point at any country — I'll switch geo per request"*
> *"List my proxies and export them as ip:port:login:password"*
> *"Renew my expiring order for another month"*

Every purchase is **quoted first** and charged only after you confirm, from a **prepaid balance** you control. No cards on file, no surprise bills.

```
Server URL:  https://api.sotaproxy.com/mcp
Transport:   Streamable HTTP (stateless)
Auth:        Bearer API key  ·  or  ?key= URL parameter
Tools:       19
```

Nothing to install — the server is hosted and always up to date.

---

## Quick start

### 1. Get an API key (once)

1. Sign up at [app.sotaproxy.com](https://app.sotaproxy.com/signup) and top up your balance (crypto, no KYC).
2. Open the **API** section in the dashboard sidebar → **Create new key** with the `read` and `trade` scopes.
3. Copy the key — it starts with `sk_live_` and is shown only once.

### 2. Connect your client

**Claude.ai / Claude Desktop** — Settings → Connectors → *Add custom connector*:

```
https://api.sotaproxy.com/mcp?key=sk_live_YOUR_KEY
```

**Claude Code:**

```bash
claude mcp add --transport http sotaproxy https://api.sotaproxy.com/mcp \
  --header "Authorization: Bearer sk_live_YOUR_KEY"
```

**Cursor / generic MCP config** (`~/.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "sotaproxy": {
      "url": "https://api.sotaproxy.com/mcp",
      "headers": { "Authorization": "Bearer sk_live_YOUR_KEY" }
    }
  }
}
```

Then ask *"What's my SotaProxy balance?"* — an answer means you're connected.

---

## Tools

| Group | Tool | What it does |
|---|---|---|
| Account | `get_balance` | Prepaid balance available to spend |
| | `list_products` | Sellable products with countries and rental periods |
| IPv4 / IPv6 / ISP | `quote_order` | Exact price for a prospective order — no charge |
| | `buy_proxies` | Buy proxies (quotes first, asks for confirmation) |
| | `list_orders` | Order history |
| | `get_order_proxies` | Issued credentials — JSON or `ip:port:login:password` |
| | `list_proxies` | Every active proxy on the account |
| Renewals | `quote_renewal` | Price to renew a whole order — no charge |
| | `renew_order` | Renew after you confirm the price |
| Residential | `residential_plans` | GB packages with your account pricing |
| | `residential_locations` | Countries → regions → cities → ISPs for geo targeting |
| | `buy_residential_package` | Buy a GB traffic package |
| | `residential_packages` | Your packages and remaining traffic |
| | `residential_universal_access` | **One login, any location** — geo & sticky sessions set via login suffixes (`login_c_US_city_New-York_s_1_ttl_15m`), no endpoints needed |
| | `create_residential_endpoint` | Endpoint with pinned geo & rotation → credentials |
| | `list_residential_endpoints` | Your endpoints with credentials |
| | `delete_residential_endpoint` | Remove an endpoint |
| Mobile | `mobile_tariffs` | Country + carrier + period catalog with unit prices |
| | `buy_mobile_proxies` | Buy mobile proxies from a tariff |

## Products

- **Residential** — traffic-based (per GB), geo targeting down to city/ISP, rotating or sticky sessions. 230+ locations. Two access modes: pinned endpoints, or a **universal login** that switches location per request via login suffixes.
- **ISP (static residential)** — datacenter speed on residential ASNs.
- **IPv4 / IPv6** — datacenter proxies from $0.20, weekly to yearly rentals.
- **Mobile** — real 4G/LTE modems by country + carrier.

## Built so an agent can't surprise you

- **Quote before charge** — money-moving tools instruct the assistant to fetch the exact price and get your explicit confirmation first.
- **Prepaid balance only** — an agent can never spend more than you've topped up.
- **Scoped keys** — a `read`-only key can browse but never buy. Revoke a key and the connector goes dark instantly.
- **Idempotent purchases** — a network retry can never double-charge.

## Links

- 📖 [Full MCP guide](https://sotaproxy.com/mcp)
- 🔌 [REST API documentation](https://sotaproxy.com/en/api-docs) — everything the MCP server does is also plain HTTP
- 🖥 [Dashboard](https://app.sotaproxy.com)
- ✉️ [Support](https://sotaproxy.com/support)

---

© SotaProxy · Private proxy service