# PapaProxy.net API and MCP server

> Manage proxies, orders, and billing for your PapaProxy.net account. The REST API and the remote MCP server expose the same operations as the PapaProxy.net Dashboard and use the same scoped API keys.

- Base URL: `https://papaproxy.net/account_new/api/v1`; authentication: `Authorization: Bearer <api_key>`.
- MCP endpoint: `https://papaproxy.net/account_new/api/v1/mcp` (remote server, HTTP transport).
- Price quotes and the country catalog work without a key; everything else needs a key with the matching scope.
- Show the user a quote and get confirmation before any purchase; send an idempotency key with paid operations that may be retried.

## Start here

- [Developer guide](https://papaproxy.net/developers.md): authentication, scopes, MCP setup, first requests, and rules for agents
- [API reference overview](https://papaproxy.net/developers/reference/index.md): base URL, authentication, errors, rate limits, and pagination
- [OpenAPI 3.1 specification](https://papaproxy.net/openapi.json): machine-readable description of every endpoint, scope, and schema
- [Complete developer documentation](https://papaproxy.net/llms-full.txt): the developer guide and the full API reference in one file

## API reference

- [Catalog and pricing](https://papaproxy.net/developers/reference/catalog-and-pricing.md): List available countries, get pricing terms, distribute IPs across countries, get a price quote, list products, get a product
- [Orders](https://papaproxy.net/developers/reference/orders.md): Place an order, quote additional IPs, add IPs to a service
- [Dedicated proxies](https://papaproxy.net/developers/reference/dedicated-proxies.md): Dedicated datacenter and ISP proxies: IPs reserved exclusively for you, from 1 IP per order
- [Services](https://papaproxy.net/developers/reference/services.md): List your services, buy a service, get a service, renew a service, cancel a service, get usage statistics
- [Proxy access](https://papaproxy.net/developers/reference/proxy-access.md): List proxy IPs, get proxy credentials, change proxy credentials, list whitelisted IPs, add a whitelisted IP, remove a whitelisted IP, check IP refresh cost, refresh proxy IPs
- [Rotating sessions](https://papaproxy.net/developers/reference/rotating-sessions.md): Get rotating gateway settings, list sticky sessions, rotate a sticky session, end a sticky session, end all sticky sessions, get session mode, set session mode, get sticky session duration, set sticky session duration, reset sticky session duration
- [Add-ons](https://papaproxy.net/developers/reference/add-ons.md): List available add-ons, buy an add-on, list active add-ons, cancel an add-on
- [Wallet](https://papaproxy.net/developers/reference/wallet.md): Get wallet balance, list wallet transactions, top up your wallet, download an invoice (PDF)
- [Account](https://papaproxy.net/developers/reference/account.md): Get your profile, update your profile
- [API keys](https://papaproxy.net/developers/reference/api-keys.md): List API keys, create an API key, revoke an API key
- [Support tickets](https://papaproxy.net/developers/reference/support-tickets.md): List support tickets, open a support ticket, get a support ticket, reply to a support ticket
- [Webhooks](https://papaproxy.net/developers/reference/webhooks.md): List webhook event types, list webhook endpoints, create a webhook endpoint, get a webhook endpoint, update a webhook endpoint, delete a webhook endpoint, list webhook deliveries, send a test event, redeliver an event

## Related

- [MCP server on GitHub](https://github.com/alexyoungpapaproxy/papaproxy-mcp): configuration examples for Cursor, Claude Code, and other MCP clients
- [Dashboard guide](https://papaproxy.net/dashboard-guide/llms.txt): the same operations done by hand in the Dashboard, including where to create API keys
- [Site overview and key facts](https://papaproxy.net/llms.txt): products, prices, protocols, and policies

## Optional

- [Developer guide in Russian](https://papaproxy.net/ru/developers.md)
- [API console](https://papaproxy.net/account_new/docs?locale=en): send test requests with your API key (requires Dashboard sign-in)