Proxy-seller

Permissions

Updated:

When you connect, the consent screen asks which permissions (OAuth scopes) to grant. Tools that belong to a permission you did not grant are not shown to the assistant at all, so it cannot call them by mistake.

Pick a combination

You want to…

Grant

Only ask API / integration questions

docs:read

Monitor proxies, usage and balance

docs:read, account:read

Manage proxies without any purchases

docs:read, account:read, account:write

Full self-service including orders

All four

Note: permissions do not include one another. account:write alone is of little use — most changes need an id that only a read tool returns. Grant account:read together with it.

The four permissions

docs:read

Spends money: no

Search and read the Proxy-Seller API documentation, get SDK snippets. Never touches your account. Always granted.

Tools: see Documentation in the tools reference.

account:read

Spends money: no

View proxies, balance, payment methods, authorizations, residential usage; preview prices.

Warning: account:read can hand out working proxy credentials. Passwords come back masked by default — export_proxies returns ip:port lines and list_auth masks the password — but the same tools take reveal: true. The assistant is instructed to do so only when you ask for the credentials (an explicit request counts as your confirmation), and once revealed they are usable by anyone who can read the conversation. See Proxy passwords and the AI provider.

account:write

Spends money: no

Change authorizations, replace proxies, add comments, manage residential lists and subpackages, turn auto-renewal and auto top-up off.

Note: turning auto-renewal or auto top-up off needs only account:write. An assistant that was never allowed to spend money can still stop a recurring charge.

billing:write

💳 Spends money: yes

Place and renew orders, buy residential traffic, turn auto-renewal and auto top-up on, top up the balance.

This is the only permission that spends money. See Payments & safety for how each action is paid and confirmed.

How sign-in works

  • You sign in on https://mcp-auth.proxy-seller.com/login with your proxy-seller.com account; the AI client receives only a short-lived access token (15 minutes), refreshed automatically.

  • The Client API key stays on the Proxy-Seller side and is never sent to the AI client or shown in the chat.

  • To change permissions, disconnect the server in your client and connect again.

  • You do not need to create a Client API key or enable API access in the dashboard. If the account has no key yet, one is generated automatically on sign-in.

  • To revoke access completely, remove the server from your client.

Next steps

On this page