Agent guides

Connect Cherry Studio to IPMusk

Import IPMusk into Cherry Studio's MCP servers. Any model you chat with there can then read your account and build proxy URLs.

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

  1. 1
    Open MCP settings

    In Cherry Studio, open Settings → MCP Servers and choose Add.

  2. 2
    Import from JSON

    Choose Import from JSON and paste the block below. Replace ipm_live_YOUR_KEY with your key.

  3. 3
    Enable the server

    Save, then switch the ipmusk server on.

Import from JSON
{
  "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.