SotaProxy

Buy and manage proxies (residential, ISP, IPv4/IPv6, mobile) from AI agents in plain language.

CommunityOnlineAPI key requiredGlobalFreeRead-only

What it can do

  • Get Balance: Get the prepaid account balance (USD). All purchases draw from this balance — check it before buying and tell the user to top up in the dashboard if it is insufficient.
  • List Products: List sellable proxy products. ipv4/ipv6/isp are period-based (pick a country id and period id from this response, then quote_order). residential is traffic-based (see residential_plans)
  • Quote Order: Price an ipv4/ipv6/isp order WITHOUT buying. ALWAYS call this before buy_proxies and show the user the exact total for confirmation. IPv6 minimum quantity is 10.

What data it sees

Do you need an account

An API key from the service settings is required

Buy and manage proxies (residential, ISP, IPv4/IPv6, mobile) from AI agents in plain language. Prepaid balance, quote-before-charge, 19 tools. Universal residential GEO login: switch country/city per request via login suffixes.

How to connect

How to connect SotaProxy to Claude

The server address to paste into Claude settings:

https://sotaproxy-mcp--support-sagp.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect SotaProxy to ChatGPT

The server address to paste into ChatGPT settings:

https://sotaproxy-mcp--support-sagp.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect SotaProxy to Cursor

The server address to paste into Cursor settings:

https://sotaproxy-mcp--support-sagp.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (19)

Raw names from tools/list. Only developers need these.

get_balanceGet the prepaid account balance (USD). All purchases draw from this balance — check it before buying and tell the user to top up in the dashboard if it is insufficient.
list_productsList sellable proxy products. ipv4/ipv6/isp are period-based (pick a country id and period id from this response, then quote_order). residential is traffic-based (see residential_plans). mobile is tariff-based (see mobile_tariffs). Country ids are PER PRODUCT — never reuse an ipv4 country id for isp.
quote_orderPrice an ipv4/ipv6/isp order WITHOUT buying. ALWAYS call this before buy_proxies and show the user the exact total for confirmation. IPv6 minimum quantity is 10.
buy_proxiesBuy ipv4/ipv6/isp proxies, charging the prepaid balance. Call quote_order first and get explicit user confirmation of the total before calling this. Proxies may take a few minutes to provision — poll get_order_proxies afterwards. Note: IPv6 serves ONE protocol chosen here via `protocol` (HTTPS default or SOCKS5) — only the matching port is issued.
list_ordersList the account's orders, newest first.
get_order_proxiesGet the issued proxies (ip, ports, login, password) for an order. Empty right after purchase means still provisioning — retry in a minute. Set format="txt" for plain ip:port:login:password lines.
list_proxiesList all active proxies on the account (ipv4/ipv6/isp/mobile). Residential endpoints are separate — use list_residential_endpoints.
quote_renewalPrice a renewal WITHOUT charging. IMPORTANT: renewal is order-level — renewing one proxy renews EVERY proxy bought in the same order, and the price covers all of them. Always show the user proxiesRenewed and price before renew_order.
renew_orderRenew a proxy's ENTIRE order (all proxies bought together), charging the balance. Call quote_renewal first and get explicit user confirmation.
residential_plansList residential traffic packages (GB) with this account's pricing. Residential is traffic-based: buy a GB package, then create endpoints with geo targeting inside it.
residential_locationsGeo catalog for residential targeting. Without arguments: all countries (code + name). With country code (e.g. "AT"): regions, cities and ISPs for that country.
buy_residential_packageBuy a residential GB package, charging the balance. Check residential_plans for the exact total and get explicit user confirmation first. After buying, create an endpoint with create_residential_endpoint to get usable credentials.
residential_packagesList the account's residential packages with remaining traffic.
create_residential_endpointCreate a proxy endpoint inside a residential package — THIS is where geo targeting is set. Returns ready-to-use credentials (host:port + login:password). rotation: 0 = new IP per request, -1 = sticky session, 1-3600 = seconds between rotations.
residential_universal_accessGet the package's UNIVERSAL geo login: one stable login/password where targeting is appended as login suffixes per request — `login_c_US`, `login_c_US_city_New-York`, sticky sessions via `_s_{id}_ttl_{30s|15m|1h}`. Prefer this over create_residential_endpoint when the user needs many locations or per-request geo switching: no endpoint creation, no port limits. Requires an active residential package.
list_residential_endpointsList the account's residential endpoints with their credentials.
delete_residential_endpointDelete a residential endpoint (its credentials stop working). Confirm with the user first.
mobile_tariffsList mobile proxy tariffs (country + carrier + rental period + unit price + stock). Filter with a country code, e.g. "DE". Check stock before buying.
buy_mobile_proxiesBuy mobile proxies from a tariff, charging the balance. Show the user unitPrice × quantity from mobile_tariffs and get explicit confirmation first. Credentials appear via get_order_proxies.