Proxidize MCP Server
Connect supported AI clients to Proxidize through the Model Context Protocol (MCP).
Manage mobile and residential proxies from any MCP-compatible AI client.
Rotate IPs, monitor usage, manage tags, and control access through natural language.
The server checks your active subscriptions when it starts.
It loads only the tools available to your account.
Requirements
You need Node.js 18 or later and a Proxidize API token.
To get your token:
Sign in to the Proxidize Dashboard.
Select your avatar, then select Settings.
Copy your API token.
Connect a client
Use the local scope for the current project:
claude mcp add proxidize -e PROXIDIZE_API_TOKEN=YOUR_API_TOKEN -- npx -y @proxidize/mcpUse the user scope for every local project:
claude mcp add proxidize --scope user -e PROXIDIZE_API_TOKEN=YOUR_API_TOKEN -- npx -y @proxidize/mcpFor shared projects, configure the token through secret management:
claude mcp add --scope project proxidize -- npx -y @proxidize/mcpRun /mcp to verify the connection.
Add this configuration to claude_desktop_config.json:
{
"mcpServers": {
"proxidize": {
"command": "npx",
"args": ["-y", "@proxidize/mcp"],
"env": {
"PROXIDIZE_API_TOKEN": "YOUR_API_TOKEN"
}
}
}
}Add this configuration to .mcp.json or your IDE's MCP settings:
{
"mcpServers": {
"proxidize": {
"command": "npx",
"args": ["-y", "@proxidize/mcp"],
"env": {
"PROXIDIZE_API_TOKEN": "YOUR_API_TOKEN"
}
}
}
}Available tools
Every installation provides these account tools:
get_subscriptionlists active subscriptions.get_outbound_ipreturns the server's public IP.
The server loads subscription-specific tools automatically.
Configuration
PROXIDIZE_API_TOKEN
Yes
None
API token for your Proxidize account.
PROXIDIZE_BASE_URL
No
https://api.proxidize.com/api/v1
API base URL.
PROXIDIZE_PROXY_HOST
No
pg.proxi.es
Proxy gateway host for connection URLs.
PROXIDIZE_TIMEOUT
No
30000
Request timeout in milliseconds.
PROXIDIZE_MAX_RETRIES
No
2
Server-error retries, from 0 to 5.
PROXIDIZE_DISABLE_ANALYTICS
No
None
Set to 1 to disable anonymous usage analytics.
The server collects anonymous tool, latency, and error data by default.
It never sends tool responses, and sensitive parameters are redacted.
Set PROXIDIZE_DISABLE_ANALYTICS=1 or DO_NOT_TRACK=1 to opt out.
Troubleshooting
PROXIDIZE_API_TOKEN is required
Add the token to your MCP client configuration.
Only account tools appear
Confirm your token and active subscription.
HTTP 401: Invalid token
Generate a new token in Settings, then update the configuration.
Requests time out
Set PROXIDIZE_TIMEOUT=60000 in the server environment.
Quick FAQ
Related articles
MCP Server repository, for source code and development instructions
Proxidize MCP Server overview, for product details
Need help?
If you have any questions, concerns, or need further clarification, feel free to reach out to us via live chat or email us directly at support@proxidize.com.
Last updated
Was this helpful?