Who this is for
Developers who use the Cline extension in VS Code, or the Cline CLI.
What you need
- An IPMusk account with a verified email address.
- An IPMusk API key. Create it in Settings → API keys (/app/settings/api-keys). For typical use tick read and connect. Add support only if the assistant should open tickets, and order only if it should create orders that end in a payment link.
- This client takes the key itself rather than reading the IPMUSK_API_KEY environment variable the other guides use. Keep the original in a password manager.
- Cline installed.
Set it up
Open the MCP Servers panel in Cline and choose Configure. This opens cline_mcp_settings.json. The Cline CLI uses ~/.cline/mcp.json. Add the server.
- Replace ipm_live_YOUR_KEY with your key. This file lives in your user settings, not in your project. Never commit it.
- Set type to streamableHttp. Older Cline versions may not support it; check Cline's current docs if the server will not start.
{
"mcpServers": {
"ipmusk": {
"type": "streamableHttp",
"url": "https://ipmusk.com/mcp",
"headers": {
"Authorization": "Bearer ipm_live_YOUR_KEY"
},
"disabled": false
}
}
}Check it works
Open the MCP Servers panel. ipmusk should show as connected with its tools.
Ask the assistant: Which IPMusk account am I connected as? It should call get_account and answer with your email address.
Try these prompts
- How much IPMusk residential traffic do I have left?
- Get a sticky US proxy URL for 10 minutes and use it in this script.
- List my IPMusk Static ISP proxies and when they expire.
If it fails
- 401 authentication_required: the key in the file is wrong, revoked or expired. Paste it again without extra spaces.
- The server fails to start: check type is streamableHttp and the JSON is valid.
- 403 forbidden on one tool: the key lacks that tool's scope, or your email is not verified. Scopes cannot be added to a key, so create a new key with the scope and swap it in.
- 429 rate_limited: too many calls in one minute (read 60, connect 20, support 30, order 10). Wait a minute and try again.
Remove access
- Revoke the key in Settings → API keys (/app/settings/api-keys). It stops working at once.
- Then delete the ipmusk entry from cline_mcp_settings.json.