MCP Server

Model Context Protocol

Control your proxies from any AI agent

The official Proxidize MCP server. Rotate IPs, switch locations, monitor usage, tag proxies, and control access — all through natural language, in Claude, Cursor, and any other MCP client.

bash

View on GitHubView on npm

Free & open source (MIT)
Works with any MCP client

proxidize-mcp

$ claude mcp add proxidize -e PROXIDIZE_API_TOKEN=*** -- npx -y @proxidize/mcp

› Rotate my Chicago proxy and give me the new IP

⏺ rotate_proxy(city: "chicago")

⎿ old_ip → new_ip (T-Mobile, Chicago)

Rotated — you're now on a fresh T-Mobile IP in Chicago.

Overview

Your proxy infrastructure, one prompt away

The Proxidize MCP server gives Claude, Cursor, and other MCP clients direct access to your proxy infrastructure — no dashboard tab-switching required.

On startup it checks which Proxidize subscriptions are active on your account and registers only the relevant tools. A Per Proxy plan gets proxy management tools, Per GB gets usage and access point tools, and so on — nothing is exposed that your account can't use.

Smart tool discovery

14 tools for Per Proxy subscribers, 9 for Per GB mobile, 9 for Per GB residential, 3 analytics tools for any active plan, plus 2 account tools that always load — 37 tools total, scoped automatically to what you actually pay for.

Features

Built for AI agents, not another dashboard

A thin, well-behaved MCP server on top of the Proxidize API — nothing to babysit.

Control proxies in plain language

Rotate IPs, switch cities, check usage, and manage access points by asking your AI agent — no dashboard tab-switching.

Registers only what you can use

On startup it checks your active Proxidize subscriptions and registers tools for those plans only — nothing you can't call.

Works with any MCP client

Claude Code, Claude Desktop, Cursor, Windsurf, and VS Code — anything that speaks the Model Context Protocol.

One command to install

npx -y @proxidize/mcp. No build step, no local checkout, no dependencies to manage.

Built-in usage analytics

Ask for bandwidth trends, top destination domains, or a full per-request connection history.

Open source, MIT licensed

Inspect the source, self-host from a local build, or open a pull request on GitHub.

Available tools

37 tools, grouped by what you're subscribed to

Every tool the server can register, organized the same way the server discovers them at startup.

Account

Always loaded

get_subscriptionget_outbound_ip

Per Proxy — dedicated mobile

14 tools

list_proxiesget_proxyrotate_proxyrotate_proxy_urlset_rotation_interval+9 more

Per GB Mobile

9 tools · mobile_ prefix

mobile_get_usagemobile_list_locationsmobile_list_carriersmobile_get_settingsmobile_list_access_points+4 more

Analytics

3 tools · any active plan

get_traffic_analyticsget_top_domainsget_connection_history

Per GB Residential

9 tools · residential_ prefix

residential_get_usageresidential_list_locationsresidential_list_carriersresidential_get_settingsresidential_list_access_points+4 more

Full tool reference and parameters are documented on GitHub.

Quick start

Up and running in under a minute

Grab your API token, add the server to your client, and start asking.

1
Get your API token
Log in to the Proxidize dashboard, open the avatar dropdown → Settings, and copy your API token.
2
Add the server to your client
Point Claude Code, Claude Desktop, Cursor, Windsurf, or VS Code at npx -y @proxidize/mcp with your token as an environment variable.
3
Start asking
Run /mcp in Claude Code to confirm the connection, then rotate IPs, check usage, or manage access points in plain language.

bash

Supported clients:Claude CodeClaude DesktopCursorWindsurfVS Code

FAQ

Got questions?
We've got answers.

Quick answers about installing and using the Proxidize MCP server.

Talk to our team

It's an MCP (Model Context Protocol) server that gives AI agents like Claude direct access to your Proxidize account — rotating IPs, switching locations, checking usage, and managing access points through natural language instead of the dashboard.

Yes. The MCP server itself is free and open source under the MIT license. You need an active Proxidize subscription for the proxy-management tools to do anything, since they act on your account.

Any MCP-compatible client, including Claude Code, Claude Desktop, Cursor, Windsurf, and VS Code with the MCP extension.

No build step. Point your client at npx -y @proxidize/mcp and Node.js 18+ downloads and runs it on demand.

Those two tools always load. Every other tool is registered based on your account's active subscriptions — no Per Proxy plan means no Per Proxy tools, for example. Regenerate your API token from the dashboard if tool discovery isn't finding an active plan.

The server collects anonymous usage analytics (which tools are called, latency, error rates) via PostHog to help improve it. Tool responses and parameter values are never sent, and sensitive values are redacted automatically. Set PROXIDIZE_DISABLE_ANALYTICS=1 or DO_NOT_TRACK=1 to opt out.

Yes. Clone the GitHub repo, run npm install && npm run build, then point your MCP client at the build output instead of npx.

Add Proxidize to your AI agent

Free, open source, and ready in one command. Pair it with Proxidize mobile or residential proxies.