Proxmint MCP server
Commit Oct 31, 2026Fetch web pages through residential, datacenter, or mobile proxies and manage proxy account details, usage, and pricing.
Also known as proxmint/mcp, mcp
- Stars
- 1
- Tools
- 6
- Downloads, 30 days
- —
- Latest version
- 1.1.0
- Last commit
- Oct 31, 2026
- License
- MIT
What is Proxmint MCP?
Proxmint fetches web pages through residential, datacenter, or mobile proxies and manage proxy account details, usage, and pricing. It exposes 6 tools, such as get_pricing, get_account, get_usage.
Summary generated from the project's README
About Proxmint MCP server
Proxmint provides a hosted MCP server that connects AI clients like Claude and Cursor to your proxy account. It allows you to manage residential, datacenter, and mobile proxy services directly through a chat interface. You can monitor your account balance, check remaining bandwidth, and view daily usage statistics for up to 90 days. The server is accessed via a remote HTTP connection, meaning no local installation is required.
Developers can use specific tools to fetch web pages as readable text or HTML, generate proxy lines with sticky sessions, and test connections to verify exit IPs. The server includes specialized skills for configuring various programming environments like Python, Node.js, or Playwright. While it can read data and fetch content, it cannot perform actions like buying new packs or changing account passwords. Access requires a read-only API key starting with the pmk_ prefix.
What you can do with it
- 1Monitor proxy account statusAsk the AI to check your remaining bandwidth and current account balance.
- 2Scrape web content via proxiesRequest the AI to fetch a specific URL using a residential or mobile proxy.
- 3Generate targeted proxy credentialsCreate proxy lines for a specific city or country with a set session duration.
- 4Debug connection issuesUse the troubleshooting skill to identify why a proxy connection is returning errors.
Written from the project's README. Every use case is checked against a quote from it.
How to install Proxmint MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Proxmint MCP in Claude Code
$ claude mcp add --transport http mcp https://proxmint.com/api/mcpInstall Proxmint MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://proxmint.com/api/mcp"
}
}
}Install Proxmint MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://proxmint.com/api/mcp"
}
}
}Install Proxmint MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://proxmint.com/api/mcp"}'Install Proxmint MCP in Codex
$ codex mcp add mcp --url https://proxmint.com/api/mcpInstall Proxmint MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] url = "https://proxmint.com/api/mcp"
Install Proxmint MCP in Gemini CLI
$ gemini mcp add -s user --transport http mcp https://proxmint.com/api/mcpInstall Proxmint MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://proxmint.com/api/mcp",
"type": "http"
}
}
}Proxmint MCP tools 6
Detected from the READMEget_pricingget_accountget_usagegenerate_proxiescheck_connectionfetch_url
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableproxmint/mcp is public and reachablegithub.com/proxmint/mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-31github.com/proxmint/mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 747 msPass
README
View on GitHubProxmint 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.
Claude and Cursor plugin
This repository is also a Claude plugin (.claude-plugin/plugin.json) and a Cursor plugin
(.cursor-plugin/plugin.json). Both connect the hosted server and add three skills:
| Skill | What it does |
|---|---|
proxmint-proxy-setup |
Configures curl, Python (requests, httpx, aiohttp, Scrapy), Node.js, Go, Playwright, Puppeteer or Selenium to use Proxmint, with credentials read from the environment |
proxmint-targeting |
Builds proxy usernames for country, state, city, ZIP or ASN targeting and sticky sessions |
proxmint-troubleshooting |
Finds the cause of 407, 403, 502 and 503 errors, failed tunnels, wrong-country exits and IP leaks |
What the plugin sends, and where:
https://proxmint.com/api/mcp, the declared MCP server: the tool calls Claude makes.gw.proxmint.com, Proxmint's proxy gateway: when the setup or troubleshooting skill tests a connection (for examplecurl -x "http://$PROXMINT_USERNAME:$PROXMINT_PASSWORD@gw.proxmint.com:823" https://api.ipify.org), your own proxy login goes to the gateway, read from your environment, never written into a file.https://api.ipify.org: that test request, sent through the proxy, which answers with the exit IP.
Nothing else is contacted, and the skills run a test only when you ask to check or debug a connection.
- Claude (
.mcp.json):get_pricingworks straight away. The first account tool asks you to sign in to Proxmint in the browser, and the sign-in creates a read-only key for Claude that you can revoke under Settings. - Cursor (
mcp.json): after installing, setPROXMINT_API_KEYto yourpmk_key under Plugins → Configure.
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 key. The server keeps nothing and does not log tool arguments, results or keys. Full docs: proxmint.com/docs/mcp.
Links
License
MIT
Proxmint MCP questions
How do I add Proxmint MCP to Claude Code?
Run claude mcp add --transport http mcp https://proxmint.com/api/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Proxmint MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Proxmint MCP provide?
It exposes 6 tools, including get_pricing, get_account, get_usage, generate_proxies, check_connection.
Can the server perform account actions like buying or topping up?
No, the server is read-only and cannot buy, top up, change targeting, or rotate passwords.
Does the fetch tool run JavaScript?
No, the fetch_url tool does not run JavaScript and leaves binary files unread.
How do I secure my proxy credentials?
The generate_proxies tool returns your proxy password, so you should keep your API key out of shared configs and revoke it in Settings if it leaks.
What are the rate limits for the account tools?
Account tools are subject to a limit of 60 requests per minute per key.