Portproof — Claude Code MCP server: proxies and setup
The Portproof MCP server for Claude Code builds connections through mobile and residential proxy pools. An agent can inspect traffic, select a country and protocol, then test the connection.
MIT updated 2026-11-16
claude mcp add --env PORTPROOF_API_KEY=<PORTPROOF_API_KEY> --env PORTPROOF_API_URL=<PORTPROOF_API_URL> --transport stdio portproof -- npx -y @portproof/mcpWhat Portproof does
Portproof reports account traffic, pricing and country coverage. It can create an HTTP or SOCKS5 proxy address and run a connection test. The pools share prepaid traffic. A sticky session keeps its device while online, though the IP can still change.
Public information is available without a key. Account actions need PORTPROOF_API_KEY with ports:read or ports:write permissions; purchases also require confirmation and an idempotency key. The local stdio server requires Node.js 20 or later.
What it helps with
- check the account’s remaining proxy traffic
- create an HTTP or SOCKS5 connection for a country
- test whether a proxy connection works
- purchase traffic after confirming the action
Example prompts for the agent
- Show the remaining Portproof traffic and available countries.
- Create a SOCKS5 proxy for the selected country and test it.
- Buy Portproof traffic after I confirm the purchase.
How to install Portproof
Platform CLI
claude mcp add --env PORTPROOF_API_KEY=<PORTPROOF_API_KEY> --env PORTPROOF_API_URL=<PORTPROOF_API_URL> --transport stdio portproof -- npx -y @portproof/mcpReplace <…> with your own values
Platform CLI
codex mcp add portproof --env PORTPROOF_API_KEY=<PORTPROOF_API_KEY> --env PORTPROOF_API_URL=<PORTPROOF_API_URL> -- npx -y @portproof/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"portproof": {
"command": "npx",
"args": [
"-y",
"@portproof/mcp"
],
"env": {
"PORTPROOF_API_KEY": "<PORTPROOF_API_KEY>",
"PORTPROOF_API_URL": "<PORTPROOF_API_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"portproof": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@portproof/mcp"
],
"env": {
"PORTPROOF_API_KEY": "<PORTPROOF_API_KEY>",
"PORTPROOF_API_URL": "<PORTPROOF_API_URL>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e PORTPROOF_API_KEY=<PORTPROOF_API_KEY> -e PORTPROOF_API_URL=<PORTPROOF_API_URL> portproof npx -y @portproof/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Portproof
How do I install Portproof in Claude Code?
Run claude mcp add mcp -e PORTPROOF_API_KEY=<PORTPROOF_API_KEY> -- npx -y @portproof/mcp. Add a Portproof key to enable account actions.
What does Portproof do?
It exposes proxy pool details and account traffic to an agent, creates proxy connections, and tests them. The server can also purchase traffic.
What does Portproof need to run?
It requires Node.js 20 or later. Public tools work without a key; account actions need PORTPROOF_API_KEY with ports:read or ports:write permissions.