
Portproof MCP server: published release mirror for shared mobile and residential proxy traffic
Portproof MCP server: published release mirror for shared mobile and residential proxy traffic
·
Connect your agent to Portproof.
Check your GB balance, choose a pool and build a proxy connection from your MCP client. Mobile 4G/5G and residential traffic share one prepaid balance.
Website · Setup guide · Documentation · npm · Status
Local stdio server · Node.js 20+ · MIT · @portproof/[email protected]
| Your workflow | MCP tools |
|---|---|
| Check pricing and current coverage | get_pricing, list_countries, get_status |
| See your remaining traffic | get_traffic |
| Choose HTTP or SOCKS5, country and rotation | build_proxy_url |
| Test a connection | test_connection |
| Buy traffic with your confirmation | buy_traffic |
Both pools are shared. A sticky session keeps the same device while it is online; its IP address may still change.
Add this to a client supporting local stdio MCP servers. You can explore pricing, service status and current coverage without an API key.
{
"mcpServers": {
"portproof": {
"command": "npx",
"args": ["-y", "@portproof/[email protected]"]
}
}
}Open Settings → Developer → Edit Config and merge the JSON above into
claude_desktop_config.json. Keep any existing entries under mcpServers.
Save the file, fully quit Claude Desktop, then reopen it.
Official setup instructions.
Merge the JSON above into your personal ~/.cursor/mcp.json file. This makes
Portproof available across your projects without storing account configuration
in a project repository. Check the server in Cursor's MCP settings.
Official configuration guide.
Register Portproof in your personal configuration:
claude mcp add --transport stdio --scope user portproof -- npx -y @portproof/[email protected]
claude mcp get portproofOn native Windows, use cmd /c npx in place of npx in the first command.
Inside Claude Code, /mcp shows the connection status.
Official stdio setup and user scope.
Create a key in your Portproof dashboard, then use this account-enabled configuration:
{
"mcpServers": {
"portproof": {
"command": "npx",
"args": ["-y", "@portproof/[email protected]"],
"env": {
"PORTPROOF_API_KEY": "YOUR_PORTPROOF_API_KEY"
}
}
}
}Keep the real value in your MCP client's private configuration or secret store.
Never commit it to a repository or put it into a prompt. Reading a traffic balance
requires ports:read; building proxy URLs, testing connections and buying traffic
require ports:write.
For Claude Desktop and Cursor, update the same personal configuration file used
above. For Claude Code, add the env object to the portproof entry under
mcpServers in ~/.claude.json, then restart the client. Preserve its other
settings. Enter the key in that private file rather than a terminal command.
| Setting | Meaning |
|---|---|
PORTPROOF_API_KEY | Optional for public tools; required for account tools |
PORTPROOF_API_URL | Defaults to https://api.portproof.org; normally leave unset |
The server runs locally. The API URL above is not a hosted MCP endpoint.
Keys act on real account credit; there is no sandbox selected by a key prefix.
Connection tests use a small amount of traffic. Purchases require confirm: true
and an idempotency_key; traffic purchases also require accept_terms: true.
The server instructs the client to ask before confirming those actions.
Passwords in generated proxy URLs stay masked unless explicitly requested.
The published bundle also exposes port-management tools; actual availability and eligibility are determined by the service. See the documentation for the current offer and tool behavior.
This is a release mirror of @portproof/mcp 0.2.1, containing the published
JavaScript bundle. The shop and original TypeScript development workspace remain
private. Release provenance records the npm tarball
integrity and published file hashes.
git clone https://github.com/portproofas/portproof-mcp.git
cd portproof-mcp
npm ci --ignore-scripts --no-audit --no-fund
npm run check
npm test
node dist/index.js --helpFor a local MCP client, use node with the absolute path to dist/index.js.
No build step is required. package.json is adapted for standalone installation
and marked private to prevent accidentally republishing the mirror. The npm
package's original manifest is retained as upstream-package.json.
The lockfile fixes the dependency versions used by this checkout. GitHub Actions runs the syntax and smoke checks on Node.js 20, 22 and 24, including a Windows check on Node.js 22. The smoke tests check the published-file hashes, stdio tool discovery and purchase guards without using an account or calling the live API.
org.portproof/mcpserver.json describes the existing npm release. Its repository field points to
this mirror; updating that local file does not update the hosted Registry.
Use Portproof for lawful price monitoring, ad verification, market research, QA, geo-testing and agent workflows. Follow each destination site's terms and Portproof's acceptable-use policy.
MIT. Runtime dependencies retain their own licenses.
Portproof · Get proxies · Contact support
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add portproof -- npx -y @portproof/[email protected]{
"mcpServers": {
"portproof": {
"args": [
"-y",
"@portproof/[email protected]"
],
"command": "npx"
}
}
}code --add-mcp '{"name":"portproof","args":["-y","@portproof/[email protected]"],"command":"npx"}'[mcp_servers.portproof]
command = "npx"
args = ["-y", "@portproof/[email protected]"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/portproof-mcp to learn what the "Portproof MCP" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add --transport stdio --scope user portproof -- npx -y @portproof/[email protected]| Name | What it does |
|---|---|
get_pricing | Public price table. Field traffic: proxy traffic by the GB (tier table with the per-GB price by order size in EUR cents ex VAT, package sizes, the 0.5 GB trial, validity days, monthly GB without compa |
search_inventory | Dedicated mobile ports: available Own network dedicated mobile ports per country / site / carrier, with the number available and whether new ports are wait-listed. Use the returned carrier_id to pin a |
quote | Price a purchase before buying: unit price, volume discount and total in cents for a SKU, term (monthly | weekly | daily) and quantity. For a Partner network SKU (buy_via "cart") the answer is its lis |
buy_port | Dedicated mobile ports: buy one dedicated mobile port (one modem, one SIM, one customer) for a SKU and term; check search_inventory first. For proxies by the GB use buy_traffic instead. CHARGES MONEY: |
list_ports | List the ports owned by this API key as compact summaries: label (country, carrier, port id), network (own = Own network, partner = Partner network), state, egress IPs, rotation, usage, subscription e |
get_port | Full detail for one port: label, network, state, carrier, listeners, credentials (only if you own it), allowlist, egress IPs, rotation settings, usage today, uptime and subscription. Partner network p |
rotate | Rotate IP: request a new egress IP for a port and wait (up to 180 s in all) for the rotation record, signed on the device for Own network ports (evidence: signed) or recorded by our monitoring for Par |
set_rotation_schedule | Set the automatic rotation interval for a port: 0 = sticky (never rotate on a schedule), otherwise 60..86400 seconds. The schedule keeps running between API calls. When get_port shows capabilities.rot |
renew_port | Dedicated ports: renew one port for one more term now, paid from the account balance. Read get_port first: renewal.can_renew says whether it can be renewed now and renewal.price_cents what one more te |
set_auto_renew | Dedicated ports: switch auto-renew of one port on or off. On: the port is renewed from the account balance shortly before its term ends (a short balance means it ends). Off: the port ends at the end o |
get_passport | Port details (API object: passport): label (country, carrier, port id), network (own = Own network, partner = Partner network), carrier, egress IPs, geo consensus, reputation, rotation and uptime stat |
get_receipt | Fetch one rotation record from the rotation log by id (rot_...): old/new IPs, whether the IP actually changed, attempts, timing, carrier, geo and reputation snapshot, plus the Ed25519 signature. Recor |
get_usage | Traffic for one port over a time window: bytes in/out, peak concurrent sessions, new connections and rotations per bucket, plus totals. Default granularity is hour; use day for long windows to keep th |
get_status | Public status page data: platform state, per-site uptime and live port counts, per-carrier uptime / first-attempt rotation success / p50 rotation time / published rotation floor, public incidents from |
get_traffic | Proxy traffic balance of the organisation: GB total / used / left, expiry, whether the key is enabled, daily usage and the purchase limits (validity days, monthly GB without company verification, whet |
list_countries | Countries with devices online now, per pool: mobile (4G/5G carrier modems, only in US, GB, FR, NL, PL, GE = Georgia (country)) and residential (opt-in peer devices), with totals. Coverage changes thro |
build_proxy_url | Build the proxy username and URL for one connection: pool, country, rotation and an optional session name are encoded in the username (validated by the server: an ISO 3166-1 alpha-2 country or "any", |
buy_traffic | Buy whole GB of proxy traffic (or the one-off 0.5 GB trial) from the wallet balance. CHARGES MONEY: requires confirm: true, accept_terms: true (the user accepts the terms, the acceptable-use policy an |
test_connection | The API sends one request through the gateway with the given pool, country and rotation and reports ok, the exit IP it saw, the latency and, on failure, the gateway error_code (for example E_NO_STOCK_ |
Read live from the server on November 6, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/portproof-mcp)Nothing comparable is listed yet.
v0.2.1Portproof MCP 0.2.1Release notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "portproof-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.