Who this is for
People who use Cherry Studio, the desktop AI chat client, with DeepSeek, Qwen, Kimi or any other model.
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.
- Cherry Studio installed, and a model that supports tool calling.
- IPMusk applies the same source-country rules to the API and MCP as to the website, so connect from a region where ipmusk.com is available.
Set it up
- 1Open MCP settings
In Cherry Studio, open Settings → MCP Servers and choose Add.
- 2Import from JSON
Choose Import from JSON and paste the block below. Replace ipm_live_YOUR_KEY with your key.
- 3Enable the server
Save, then switch the ipmusk server on.
{
"mcpServers": {
"ipmusk": {
"type": "streamableHttp",
"url": "https://ipmusk.com/mcp",
"headers": {
"Authorization": "Bearer ipm_live_YOUR_KEY"
}
}
}
}Menu names change between releases. If a step does not match, check Cherry Studio's current documentation.
Check it works
Open a chat and pick IPMusk in the chat's MCP menu. Its tools should be listed.
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 residential traffic do I have left on IPMusk?
- Give me a rotating residential proxy URL for Germany.
- List my Static ISP proxies and when they expire.
If it fails
- 401 authentication_required: the key is wrong, revoked or expired. Paste it again without extra spaces.
- The tools do not appear in chat: the server is switched off, or not picked in the chat's MCP menu.
- The model never calls a tool: pick a model that supports tool calling (function calling).
- 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 server in Settings → MCP Servers.