Content
# 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"*
> *"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: 18
```
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 |
| | `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), per-endpoint geo targeting down to city/ISP, rotating or sticky sessions. 230+ locations.
- **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
