An astronaut overseeing a futuristic data hub
Download PDFMarkdown Version

Connect Iproyal Proxy Services to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Run your entire proxy network through natural conversation.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

A futuristic MCP client docking bay
V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 10 capabilities

We ship only the actions that matter.

Capability set01 / 03

01-04

4 capabilities in this set.

Part of 10 available through IPRoyal.

  1. 01

    Get availability

    Checks proxy IP availability in specific countries. Use this to confirm a target region has enough IPs before starting a crawl.

  2. 02

    Get profile

    Retrieves your IPRoyal account balance and profile details. Use this to ensure you have enough funds for upcoming scraping tasks.

  3. 03

    List countries

    Provides a list of supported country codes, cities, and ISPs. This is used to find the right identifiers for geo-targeted connection strings.

  4. 04

    List orders

    Lists all your active proxy orders, including Residential and Datacenter batches. It returns the order IDs needed for traffic and credential management.

Capability set02 / 03

05-07

3 capabilities in this set.

Part of 10 available through IPRoyal.

  1. 05

    List whitelisted ips

    Shows the IP addresses currently authorized for user/pass-free access. Use this to audit which IPs can connect to your proxies.

  2. 06

    Remove whitelist ip

    Revokes access for a specific IP address. This is useful for cleaning up permissions when you decommission a scraping server.

  3. 07

    Add whitelist ip

    Authorizes a new IP address for proxy access. This allows your headless scrapers to connect without needing usernames or passwords in the code.

Capability set03 / 03

08-10

3 capabilities in this set.

Part of 10 available through IPRoyal.

  1. 08

    Change credentials

    Updates the username and password for a specific proxy order. Use this to rotate keys if you suspect a credential leak.

  2. 09

    Generate proxy string

    Creates a formatted proxy connection string. You can specify a country for geographic targeting or a session ID for sticky IPs.

  3. 10

    Get traffic

    Fetches real-time bandwidth consumption stats for a specific order. Use this to monitor residential proxy usage and prevent overages.

Real work

What teams actually run

01

Automated Scraping Prep

Verify that a specific country has enough residential IPs before launching a massive crawl.

02

Security Response

Instantly rotate proxy passwords via your AI client if you detect a credential leak.

03

Headless Server Setup

Add a new server IP to your whitelist so your scrapers can connect without hardcoded credentials.

04

Budget Management

Check real-time traffic consumption for residential proxy orders to avoid overages.

Automate a task

Put IPRoyal to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

IPRoyal works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

ClaudeClaudeChatGPTChatGPTGeminiGeminiPerplexityPerplexityGrokGrokMicrosoft CopilotMicrosoft CopilotCursorCursorVS CodeVS CodeWindsurfWindsurfJetBrainsJetBrainsClineClineLangChainLangChainVercel AI SDKVercel AI SDKLovableLovableZ.aiZ.aiRaycastRaycastQwen CodeQwen CodeKimi CodeKimi CodeLe ChatLe Chat

Building your own app? The connector is yours to use.

You don't need a client to put IPRoyal to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

930ms average. Fast in production.

IPRoyal is checked daily against the live service.

Daily averagePeak 1140ms
Oct 3Today
Fastest day
728ms
Slowest day
1140ms
14-day trend
Stable+3%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 10 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of IPRoyal, so you can see the experience inside your AI.

It does not authenticate your account with IPRoyal. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

IPRoyal Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_ufj8i7Qawm5R8Yoequxc3gAiMLIBTNP2yijAnz5x/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — IPRoyal capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "iproyal-proxy-services-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_ufj8i7Qawm5R8Yoequxc3gAiMLIBTNP2yijAnz5x/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up IPRoyal in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work IPRoyal owners hand off.

This MCP is built for professionals managing large-scale web scraping and automated data collection.

  • 01

    Data Scientists

    They use the agent to automate geo-targeted data collection and monitor traffic usage.

  • 02

    Security Engineers

    They use the agent to rotate credentials and manage whitelisted IPs across different environments.

  • 03

    Automation Developers

    They use the agent to generate complex connection strings and verify IP availability before running crawls.

FAQ

Questions IPRoyal owners ask.

  • 01

    How do I connect this MCP to my AI client?

    Subscribe to the MCP on Vinkius and enter your IPRoyal API Access Token. Once connected, you can use it immediately in Claude, Cursor, or Windsurf.

  • 02

    Can I use this for residential proxies?

    Yes. You can monitor traffic for residential orders and generate geo-targeted strings specifically for residential IP pools.

  • 03

    Does this work with any AI client?

    It works with any MCP-compatible client, including Claude, Cursor, and Windsurf.

  • 04

    How do I rotate my proxy passwords?

    You can simply ask your AI agent to change the credentials for a specific proxy order, and it will update them instantly.

  • 05

    Can I manage my IP whitelist through the AI?

    Yes. You can add or remove IP addresses from your whitelist using natural language commands.

  • 06

    Can I check how much bandwidth I've consumed for a specific proxy order?

    Yes. Use the get_traffic capability with your Order ID. Your agent will return the exact amount of data used in GB/MB, helping you avoid unexpected depletion of funds for residential proxies.

  • 07

    How do I whitelist my server's IP address through my agent?

    The add_whitelist_ip capability allows your agent to authorize a specific IPv4 address for a proxy order. This enables user/pass-free authentication, which is more secure for headless scrapers and backend servers.

  • 08

    Can I check if residential proxies are available in a specific country?

    Absolutely. Use the get_availability capability and specify the product (e.g. 'residential'). Your agent will return a live count of online proxies in the IPRoyal pool for each country.

Explore

More in Developer Tools

Suggestions

Connect IPRoyal to Claude, Cursor, ChatGPT & more