IPRoyal (Proxy Services) Connector for AI agents.
10 live capabilities
Manage your global proxy infrastructure and web scraping operations with natural conversation.
Waiting for input…
Why people use IPRoyal (Proxy Services)
IPRoyal (Proxy Services) for Scraping Infrastructure Management
This Connector changes that by putting your entire proxy network into a single chat window. You can ask your agent to do the heavy lifting like auditing your account, updating credentials, or whitelisting your new servers. You get a unified way to manage your infrastructure without the constant context switching.
What Vinkius changes
You get a conversational way to manage your proxy network without leaving your AI client.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Geo-targeted data collection
A researcher needs to scrape data from 10 different countries.
- Real-world use case 02
Securing headless scrapers
A developer wants to move away from hardcoding credentials.
- Real-world use case 03
Emergency credential rotation
An engineer suspects a proxy key leak.
Complete set · 10capabilities
The complete IPRoyal (Proxy Services) capability set.
These are the exact actions your AI can choose when you ask it to work with IPRoyal (Proxy Services).
01—04
4 capabilities in this set.
Part of 10 available through IPRoyal (Proxy Services).
- 01 Capability
Get availability
Check if a target region has enough residential IPs. Use this to verify capacity before starting a crawl.
- 02 Capability
List countries
Get a list of supported country codes and region identifiers. Use these to build your geo-targeted proxy strings.
- 03 Capability
Change credentials
Update the username and password for a specific proxy order. This is perfect for rotating keys if a leak is suspected.
- 04 Capability
List whitelisted ips
See which IP addresses are currently allowed to connect without a username or password. Use this to audit your access.
05—07
3 capabilities in this set.
Part of 10 available through IPRoyal (Proxy Services).
- 05 Capability
List orders
Retrieve all active residential and datacenter proxy orders. This gives you the IDs needed for traffic lookups.
- 06 Capability
Get profile
Get your current account balance and profile details. Use this to make sure you have enough funds for a big run.
- 07 Capability
Generate proxy string
Create a dynamic geo-targeted proxy string. You can specify countries and sticky sessions in the request.
08—10
3 capabilities in this set.
Part of 10 available through IPRoyal (Proxy Services).
- 08 Capability
Remove whitelist ip
Revoke an IP from your whitelist. Use this to clean up access once a scraping server is decommissioned.
- 09 Capability
Add whitelist ip
Authorize a specific IP address for IPRoyal proxy access. This keeps your scraper credentials out of your source code.
- 10 Capability
Get traffic
Check the precise bandwidth consumption for a specific order. This helps prevent unexpected fund depletion.
Set up in minutes
One URL. Then ask IPRoyal (Proxy Services) to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use IPRoyal (Proxy Services) from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_ufj8i7Qawm5R8Yoequxc3gAiMLIBTNP2yijAnz5x/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it IPRoyal (Proxy Services), and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable IPRoyal (Proxy Services) for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_ufj8i7Qawm5R8Yoequxc3gAiMLIBTNP2yijAnz5x/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the IPRoyal (Proxy Services) URL.
- Step 03
Save and start
Save the connection and enable IPRoyal (Proxy Services) in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"iproyal-proxy-services": {
"url": "https://edge.vinkius.com/vk_preview_ufj8i7Qawm5R8Yoequxc3gAiMLIBTNP2yijAnz5x/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using IPRoyal (Proxy Services)
Open Agent mode in chat and ask: "Using IPRoyal (Proxy Services), help me...". 10 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"iproyal-proxy-services": {
"url": "https://edge.vinkius.com/vk_preview_ufj8i7Qawm5R8Yoequxc3gAiMLIBTNP2yijAnz5x/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using IPRoyal (Proxy Services)
Ask Copilot: "Using IPRoyal (Proxy Services), help me...". 10 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"iproyal-proxy-services": {
"url": "https://edge.vinkius.com/vk_preview_ufj8i7Qawm5R8Yoequxc3gAiMLIBTNP2yijAnz5x/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using IPRoyal (Proxy Services)
Open Cascade and ask: "Using IPRoyal (Proxy Services), help me...". 10 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"iproyal-proxy-services": {
"url": "https://edge.vinkius.com/vk_preview_ufj8i7Qawm5R8Yoequxc3gAiMLIBTNP2yijAnz5x/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using IPRoyal (Proxy Services)
Ask Cline: "Using IPRoyal (Proxy Services), help me...". 10 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add iproyal-proxy-services --transport http "https://edge.vinkius.com/vk_preview_ufj8i7Qawm5R8Yoequxc3gAiMLIBTNP2yijAnz5x/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using IPRoyal (Proxy Services)
Ask Claude: "Using IPRoyal (Proxy Services), show me...". 10 tools are ready
Where the request belongs
Work IPRoyal can move forward.
This is for the engineers and data scientists who spend hours babysitting proxy connections and managing credentials across multiple scraping environments.
Data Scientist
Uses this to check regional availability and generate country-specific strings for large-scale data collection.
Security Engineer
Manages IP whitelists and rotates proxy credentials to keep headless scrapers secure and authenticated.
Automation Developer
Builds scrapers that automatically query for available bandwidth and generate connection strings on the fly.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsWebshare
Manage residential and datacenter proxies, rotation settings, and authorized IPs on Webshare. the fast and affordable proxy network.
Decodo (Smartproxy)
Manage your Decodo (formerly Smartproxy) network infrastructure. list proxy endpoints, monitor bandwidth, and fetch residential proxy configurations with your AI.
Residential Proxies
Route web traffic through residential IP addresses worldwide for scraping, testing, and research that avoids blocks and captchas.
IPQualityScore (IPQS)
Detect fraud, proxies, and malicious activity via IPQS API.
HetrixTools
Automate uptime monitoring and blacklist checks via HetrixTools. monitor servers, websites, and IP reputation directly from any AI agent.
Browserhub
Automate web scraping via Browserhub. run scrapers, manage jobs, and retrieve extracted data directly from any AI agent.
Bring your own AI
Change the model, client or framework. Keep IPRoyal connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about IPRoyal.
The practical details behind the request, access and result.
Can I use IPRoyal (Proxy Services) MCP to manage my scraping proxies?
Yes. This Connector connects your IPRoyal account to your AI client, allowing you to manage credentials, traffic, and whitelists through a chat interface.
How does IPRoyal (Proxy Services) MCP help with geo-targeting?
It allows your agent to look up supported country codes and generate specific connection strings for different regions, making it easy to target specific geographic areas.
Can I rotate my proxy credentials using IPRoyal (Proxy Services) MCP?
Yes, you can ask your agent to update the username and password for any specific proxy order instantly to maintain your security.
Does IPRoyal (Proxy Services) MCP support whitelisting my server IP?
It does. You can authorize specific IP addresses to connect to your proxies without needing to provide credentials in your source code.
How do I check my remaining bandwidth with IPRoyal (Proxy Services) MCP?
You can simply ask your agent to check the traffic consumption for a specific order ID, and it will return the amount used and remaining.
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.
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.
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.
One connection away
Give your agent a direct line to IPRoyal.
Connect IPRoyal once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available