Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add --env PORTPROOF_API_KEY=<PORTPROOF_API_KEY> --env PORTPROOF_API_URL=<PORTPROOF_API_URL> --transport stdio portproof -- npx -y @portproof/mcp
Open on GitHub

What 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/mcp

Replace <…> 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.

Similar MCP servers

MCP servers catalog →

Project sponsors

Companies that keep this analytics open