About Proxmint
Proxmint is a hosted MCP server for Proxmint account holders who need to inspect pages and proxy account data. It fetches web pages through selected residential, datacenter, or mobile proxies and provides read-only account, usage, pricing, and connection tools.
Key features
- 01Fetch pages through selected proxies
- 02Generate targeted proxy lines
- 03Check account balance and bandwidth
- 04Review daily usage and pricing
- 05Test proxy connections
Use cases
- 01Read a page through a proxy in a chosen country
- 02Check remaining bandwidth and daily usage
- 03Generate sticky proxies for a city
MCP support
The hosted MCP server exposes Proxmint pricing, account, usage, proxy generation, connection testing, and page-fetching tools to MCP clients. Account-specific tools require an API key.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://proxmint.com/api/mcpclaude mcp add --transport http com-proxmint https://proxmint.com/api/mcp{"mcpServers":{"com-proxmint":{"type":"http","url":"https://proxmint.com/api/mcp"}}}Open in Cursor{"servers":{"com-proxmint":{"type":"http","url":"https://proxmint.com/api/mcp"}}}Open in VS Code{"mcpServers":{"com-proxmint":{"type":"http","url":"https://proxmint.com/api/mcp"}}}{"mcpServers":{"com-proxmint":{"serverUrl":"https://proxmint.com/api/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://proxmint.com/api/mcpAuth requiredTools
6| Parameter | Type | Required | Description |
|---|---|---|---|
| product | enum | No | Only this productdatacenter | residential | premium-residential | mobile |
Details
From the project READMEProxmint MCP server
Connect Claude, Cursor or any MCP client to your Proxmint account. Read a web page through your own residential, datacenter or mobile proxies, from the country you choose. Ask what a pack costs, check your balance and the bandwidth left, see daily usage, generate proxy lines for a country or city with sticky sessions, and test a connection.
The server is hosted, so there is nothing to install: https://proxmint.com/api/mcp (Streamable HTTP). It is listed
in the official MCP Registry as com.proxmint/mcp.
Tools
| Tool | What it returns | Needs a key |
|---|---|---|
get_pricing | Pack sizes, prices and price per GB for residential, premium residential, datacenter and mobile | No |
get_account | Balance, and each product's status, bandwidth used and left, host, ports and username | Yes |
get_usage | Gigabytes and requests per product per day, up to 90 days, with totals | Yes |
generate_proxies | Proxy lines: HTTP or SOCKS5, country, state, city, ZIP or ASN targeting, rotating or sticky for 1 to 120 minutes | Yes |
check_connection | One request through a product: exit IP, the country Cloudflare sees, time taken | Yes |
fetch_url | A web page fetched through a product, from its IPs and targeting: status, final URL, title, and the page as readable text or raw HTML (up to 50,000 characters) | Yes |
Every tool only reads. The server cannot buy, top up, change targeting or rotate a password. Two tools send
traffic, both through your own product and on its bandwidth: check_connection sends one request of a few
kilobytes, and fetch_url loads the page you ask for. fetch_url follows up to 5 redirects, reads at most 1 MB,
leaves binary files unread, does not run JavaScript, and refuses private addresses and ports the gateway does not
forward.
API key
Create a key under Settings in the dashboard. Keys start with
pmk_ and are read-only. generate_proxies returns your proxy password, because a working line needs it, so
keep the key out of shared configs and revoke it in Settings if it leaks.
Connect
Claude Code:
claude mcp add --transport http proxmint https://proxmint.com/api/mcp \
--header "Authorization: Bearer pmk_YOUR_KEY"
Cursor (~/.cursor/mcp.json):
{
"mcpServers": {
"proxmint": {
"url": "https://proxmint.com/api/mcp",
"headers": { "Authorization": "Bearer pmk_YOUR_KEY" }
}
}
}
Claude Desktop (claude_desktop_config.json), through mcp-remote:
{
"mcpServers": {
"proxmint": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://proxmint.com/api/mcp", "--header", "Authorization:${AUTH}"],
"env": { "AUTH": "Bearer pmk_YOUR_KEY" }
}
}
}
Limits and privacy
Account tools share the customer API's limit of 60 requests a minute per IP. The server keeps nothing and does not log tool arguments, results or keys. Full docs: proxmint.com/docs/mcp.
Links
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.