Integrations / Proxy setups / Proxies for AI agents
A proxy for every agent task.
Parallel agent tasks should not share an exit any more than they share cookies. An agent session picks the proxy when it opens: the pool proxy in the fewest open sessions, or one you name, and a returning identity always keeps its own.
{ "task": "compare prices on shop A", "mode": "ephemeral", "proxy": "pool" }Setup
Set it up.
Fill the pool
Add the proxies agents may use in Proxies, and check them. Sticky or static ones suit returning identities.
Open sessions on the pool
Over MCP, the agent passes
proxytobrowz_session_open."pool"takes the pool proxy in the fewest open sessions; an empty pool is refused rather than going direct.browz_session_open{ "task": "compare prices on shop A", "mode": "ephemeral", "proxy": "pool" }Or from the local API
Terminalexport BROWZ_TOKEN="$(cat ~/.browz/api-token)" curl -s -X POST http://127.0.0.1:50333/api/v1/agent/session/open -H "Authorization: Bearer $BROWZ_TOKEN" -H "Content-Type: application/json" \ -d '{"task":"check order status","mode":"persistent","identity":"shop-a/buyer-3","proxy":"pool"}'
Example
Tell the agent in plain words.
With the Browz MCP server in your agent client, a prompt is enough.
Using Browz, open three throwaway sessions on the proxy pool, one for each of these pages, read each page’s main heading, and close every session when you are done.Three sessions spread over the least-used pool proxies; each throwaway profile is wiped when its session closes.
Good to know
Notes and tips.
- A returning identity keeps the proxy it first opened with. Asking for a different one is refused, so an identity never shows up from somewhere new.
"none"opens a session with no proxy, on your own connection. Leaveproxyout and a new profile goes direct too, while a returning identity uses its own proxy.- Leave a profile’s timezone, language and WebRTC on automatic: Browz sets them from where the proxy really exits, measured at each check, so the profile does not contradict its own address.
- Bring proxies from any provider: Browz supports HTTP, HTTPS, SOCKS4, SOCKS5 and SSH.
- A profile whose proxy fails its exit check is refused at Start. It never falls back to your own connection.
- A proxy changes where a profile connects from, not what a site allows. Use each site only as its terms allow; our acceptable use policy applies whatever the exit.
FAQ
Proxies for AI agents and Browz.
Can the agent see the proxy password?
No. Pool proxies are referred to by id; their credentials stay sealed in Browz.
What does the agent see about the proxy?
browz_proxy_list returns the pool with names, ids and exits, not passwords, so the agent can pick one by id.
Does this work through the hosted MCP server?
Session tools are local: run the agent client on the computer with Browz, or open sessions there for it.
Get started
Download Browz. Every task, its own browser.
curl -fsSL https://gobrowz.com/agents/install.sh | sh