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.

Server tool list (19)

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

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). mobile is tariff-based (see mobile_tariffs). Country ids are PER PRODUCT — never reuse an ipv4 country id for isp.
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.
buy_proxies	Buy 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_orders	List the account's orders, newest first.
get_order_proxies	Get 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_proxies	List all active proxies on the account (ipv4/ipv6/isp/mobile). Residential endpoints are separate — use list_residential_endpoints.
quote_renewal	Price 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_order	Renew a proxy's ENTIRE order (all proxies bought together), charging the balance. Call quote_renewal first and get explicit user confirmation.
residential_plans	List 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_locations	Geo 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_package	Buy 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_packages	List the account's residential packages with remaining traffic.
create_residential_endpoint	Create 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_access	Get 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_endpoints	List the account's residential endpoints with their credentials.
delete_residential_endpoint	Delete a residential endpoint (its credentials stop working). Confirm with the user first.
mobile_tariffs	List mobile proxy tariffs (country + carrier + rental period + unit price + stock). Filter with a country code, e.g. "DE". Check stock before buying.
buy_mobile_proxies	Buy 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.