Home / Setup guides

Proxare API and MCP server

Updated November 15, 2026

Generate proxy lists, read your balance and manage your IP whitelist from code, from a proxy manager, or from an AI assistant over MCP.

Base URLhttps://www.proxare.com/v1/ — keep the trailing slash
AuthAuthorization: Bearer pxr_live_... (made in the dashboard)
MCP serverhttps://www.proxare.com/mcp/
Machine-readableOpenAPI 3.1 · llms-full.txt · llms.txt
Rate limit120 requests a minute per account
CostGenerating proxy lines is free. You pay for traffic, never for lines.

1. Make an API key

Sign in to the dashboard, open Settings and press Create key. It is shown once:

pxr_live_7Kq2xR4mNvB8cTfW1yZp6LdJhA3sEgU9nQ0rXiOk

Send it as a bearer token on every call:

Authorization: Bearer pxr_live_...

A key can read your account, generate proxy lines and change your whitelist, so treat it like a password and revoke it in the dashboard if it leaks. Keys carry three scopes — read, generate, manage — and new keys get all three. The key is not tied to an IP, so desktop software can use it directly. Nothing in the API can spend money: buying stays in the browser.

2. Your first call

What the account owns, and how much is left:

curl -s https://www.proxare.com/v1/subaccounts/ -H 'Authorization: Bearer pxr_live_...'
{
  "subaccounts": [
    { "id": "private", "name": "Proxare Premium", "type": "residential",
      "username": "px_alice", "leftGb": 43.812, "usedGb": 6.188, "limitGb": 50 }
  ]
}

The id is what every other call means by product.

3. Generate a proxy list

One call returns ready-to-paste lines, built from your own proxy login:

curl -s https://www.proxare.com/v1/proxies/ \
  -H 'Authorization: Bearer pxr_live_...' \
  -H 'Content-Type: application/json' \
  -d '{"product":"private","count":100,"country":"de","sticky":true,"format":"hpup"}'
{
  "product": "private",
  "name": "Proxare Premium",
  "count": 100,
  "host": "premium.proxare.com",
  "port": 6011,
  "username": "px_alice",
  "rotating": false,
  "countries": ["de"],
  "leftGb": 43.812,
  "proxies": ["premium.proxare.com:6011:px_alice:k7Qm2x-country-de_session-ab12cd34_lifetime-30m", "..."]
}

Write proxies straight into your proxy list file. Every line gets its own session id, so 100 lines mean 100 different IPs. Generating costs no GB, so there is no reason to cache or ration lines.

Parameters

FieldTypeMeaning
productstringRequired. Product id from /subaccounts/, e.g. private.
countnumber1–1000. Default 10.
countrystringTwo-letter code, e.g. de. Leave it out for any country.
countriesarraySeveral codes: the list is spread evenly over them.
mixedbooleanSpread the list over the standard country pool.
citystringOptional, together with a country, e.g. new_york.
carrierstringMobile only: carrier code from /countries/.
stickybooleanDefault true: one IP per line for the session lifetime. false rotates on every request.
lifetimestring10m, 30m (default) or 1h.
protocolstringhttp (default) or socks.
formatstringhpup host:port:user:pass (default), uphp user:pass@host:port, uphp2 user:pass:host:port, url http://user:pass@host:port
regionstringauto (default), eu or asia: which gateway to connect to.

Sticky or rotating? sticky: true (the default) gives each line one IP for the lifetime — right for accounts, profiles and sessions. sticky: false gives one endpoint that changes IP on every request — right for scraping. Country or region? country picks where the IP comes out; region only picks which gateway you connect to, for latency.

Line formats

formatShapeExample
hpuphost:port:user:pass
What most proxy managers import. The default.
premium.proxare.com:6011:px_alice:k7Qm2x-country-us_session-ab12cd34_lifetime-30m
uphpuser:pass@host:port
Common in browser tools and bots.
px_alice:k7Qm2x-country-us_session-ab12cd34_lifetime-30m@premium.proxare.com:6011
uphp2user:pass:host:port
Same fields, colons only.
px_alice:k7Qm2x-country-us_session-ab12cd34_lifetime-30m:premium.proxare.com:6011
urlscheme://user:pass@host:port
For curl, requests, Scrapy, Puppeteer.
http://px_alice:k7Qm2x-country-us_session-ab12cd34_lifetime-30m@premium.proxare.com:6011

Targeting lives in the credentials, not the host: the part after the password (after the username for Geonode) carries country, session and lifetime. Ask the API for lines rather than building these strings yourself.

4. Every endpoint

MethodPathWhat it does
GET/v1/products/Products, pack sizes and prices. No key needed.
GET/v1/account/Your account: every product, GB used and GB left, proxy username, whitelisted IPs.
GET/v1/subaccounts/Short list for a sub-account dropdown.
GET/v1/countries/?product=mobileCountries you can target (and mobile carriers).
GET/v1/orders/Your paid orders.
POST/v1/proxies/Generate a proxy list.
POST/v1/whitelist/Replace your IP whitelist.
POST/v1/password/Reset a product’s proxy password.

/v1/products/ and /v1/openapi/ need no key. /v1/proxies/ also accepts a GET with the same parameters in the query string, for tools that cannot POST.

Errors

Every failure is JSON with a human-readable error you can show as it is, and a short code to branch on:

codeHTTPMeaning
no_key401Missing, unknown or revoked API key.
scope403The key does not carry the scope this call needs.
product400Unknown product id.
country400Not a two-letter country code.
not_owned404You do not own that product.
no_password409No proxy password yet — call /v1/password/ first.
upstream502The proxy network could not be reached. Retry.
not_found404No such endpoint.

5. MCP server (Claude, Cursor, ChatGPT)

Proxare runs a Model Context Protocol server, so an AI assistant can look up prices, read your balance and hand you a proxy list without you leaving the chat.

https://www.proxare.com/mcp/

The trailing slash avoids a redirect; /mcp works too, for clients that follow one.

Claude Code:

claude mcp add --transport http proxare https://www.proxare.com/mcp/ \
  --header "Authorization: Bearer pxr_live_..."

Claude Desktop, Cursor and anything else that reads an mcpServers block:

{
  "mcpServers": {
    "proxare": {
      "type": "http",
      "url": "https://www.proxare.com/mcp/",
      "headers": { "Authorization": "Bearer pxr_live_..." }
    }
  }
}

Without a key the server still answers the public tools, so an assistant can compare products and prices before anyone signs up.

ToolWhat it doesNeeds
list_productsProducts and prices.no key
price_quoteWhat a pack costs.no key
buy_linkA checkout link to open. Nothing is ever paid for you.no key
setup_guideThe setup guide for AdsPower, Dolphin Anty, ScrapeBox, Scrapy or Puppeteer.no key
my_accountProducts owned, GB used and GB left.read
list_ordersPaid orders.read
list_countriesCountries and mobile carriers.read
generate_proxiesBuild a proxy list from your own login.generate
whitelist_ipsReplace the IP whitelist.manage
reset_proxy_passwordMake a new proxy password.manage

The server never pays for anything. buy_link returns a checkout URL for you to open yourself.

6. Letting an AI write the integration

Point your assistant at these and it has everything without crawling the site:

/llms-full.txtThe whole integration guide as plain text: every endpoint, every parameter, worked Python and Node examples, and the mistakes that are easy to make. Paste it into a chat or let the model fetch it.
/v1/openapi/OpenAPI 3.1. Feed it to a code generator, or to any tool that speaks OpenAPI.
/llms.txtShort index of the site in the llms.txt format.
https://www.proxare.com/mcp/Or skip the code: connect the MCP server and let the assistant call the tools itself.

A prompt that works: “Read https://www.proxare.com/llms-full.txt and write me a Python function that returns 50 sticky German proxies as a list of strings.”

7. Building a Proxare tab into your software

If you make a proxy manager, bot or scraper and want a built-in Proxare tab, three calls are enough:

  1. GET /v1/subaccounts/ — fill the sub-account dropdown and show GB left.
  2. GET /v1/countries/ — fill the country dropdown.
  3. POST /v1/proxies/ — write proxies straight into your proxy list file.

The API sends Access-Control-Allow-Origin: * and has no IP restrictions, so a desktop app or an extension can call it directly. Want a partner link, a revenue share or a sandbox key to build against? Contact us.

Questions

Does generating proxies cost GB?

No. You are billed for the traffic you push through the proxies, never for making a list. Generate as many lines as you like.

What happens when I run out of GB?

The proxy stops connecting; the API keeps answering and shows leftGb: 0. Generating still works, so you can prepare a list and top up after. The same username and password keep working after a top-up.

Can I use one key on several machines?

Yes. Keys are not tied to an IP. Make one key per app so you can revoke them separately.

How do I get a different IP?

Ask for more lines. One line is one session, so count: 100 is 100 IPs. With sticky: false a single line changes IP on every request instead.

Is there a sandbox?

Not yet. The public endpoints need no key, and a 1 GB pack is enough to test a real integration end to end.