Manage global proxies and scrape data without leaving your chat window. 
Claude 
ChatGPT 
Cursor 
Gemini 
Windsurf 
VS Code 
JetBrains 
Vercel
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Connect to your AI in seconds.
IPRoyal Proxy Services manages your entire global proxy infrastructure right from your AI agent. You monitor traffic usage, rotate credentials instantly, and manage whitelists without touching a dashboard.
Use this MCP to get precise bandwidth statistics for residential or datacenter proxies and generate dynamic connection strings based on country or sticky sessions.
What your AI can do
Add whitelist ip
Authorizes a specific IP address for proxy access without requiring a user/pass in the connection string.
Get availability
Checks if specific proxy IPs are available in target regions before starting a crawl.
List countries
Retrieves country codes and region identifiers needed to build accurate geo-targeted connection strings.
Get real-time bandwidth consumption statistics for your proxy orders, preventing unexpected depletion of funds.
Authorize or revoke specific client IP addresses to secure scrapers without needing proxy credentials.
Instantly update usernames and passwords for your proxy orders to maintain security hygiene and prevent leaks.
Generate complex connection strings that include country codes or guarantee a sticky IP session.
List all active proxy orders and check account details to plan large scraping runs.
Ask an AI about this
Compatible AI Apps
OAuth 2.0 Compatible Gemini Waiting for input…
IPRoyal (Proxy Services) MCP - 10 Tools
Use these tools to control all aspects of proxy infrastructure, from checking funds to building complex geo-targeted connection strings.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using IPRoyal (Proxy Services) on VinkiusAdd Whitelist Ip
Authorizes a specific IP address for proxy access without requiring a user/pass in the connection string.
Get Availability
Checks if specific proxy IPs are available in target regions before starting a crawl.
List Countries
Retrieves country codes and region identifiers needed to build accurate geo-targeted...
Change Credentials
Updates the username and password for an existing proxy order to fix suspected leaks...
List Whitelisted Ips
Shows which IP addresses are currently authorized to connect without credentials.
List Orders
Lists all current proxy orders, providing necessary IDs for traffic lookup or credential changes.
Get Profile
Retrieves your overall account balance and profile details to check funding levels.
Generate Proxy String
Creates a formatted connection string that supports geographic targeting or sticky...
Remove Whitelist Ip
Revokes a specific IP address's access from the proxy endpoint for security purposes.
Get Traffic
Provides precise statistics on the bandwidth consumed by a proxy order.
Connect to your AI in seconds. Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Claude AI
Open Claude Settings
Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
Add Custom Connector
Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:
https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp
Replace [YOUR_TOKEN_HERE] with your token
from cloud.vinkius.com. For OAuth-protected servers, expand
Advanced settings to add credentials.
Start a conversation
Open a new chat. The IPRoyal integration is available immediately — no restart needed.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with IPRoyal (Proxy Services), then connect any of our 5,000+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,000+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by IPRoyal. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 10 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Managing proxy access used to mean jumping through hoops.
Today, managing proxies means logging into multiple separate vendor dashboards. You check your balance in one tab, update credentials in another, and then copy-paste a complex connection string built from three different country code lists just to run the script. It's slow, prone to human error, and you lose context.
With this MCP, all that complexity goes away. Your agent handles it conversationally. You ask for an IP check or a credential update, and it executes the action instantly, giving you one clean result without leaving your chat window.
Proxy Orchestration with `generate_proxy_string`
Previously, building a geo-targeted string meant manually combining country codes and session identifiers into the correct format. If you missed one variable or used the wrong syntax, your entire crawl failed silently.
Now, just tell your agent what you need—Germany with a sticky session. It builds the full connection string for you in one step, giving you exactly what you need to run the script.
What your AI can actually do with this
Running web scraping operations means managing complex proxy networks constantly. Instead of jumping between dashboards just to check funds or update credentials, you talk to your agent. It handles the whole process: checking if you have enough budget using get_profile, verifying IP availability across dozens of countries, and generating a perfectly formatted connection string for any target region.
You also maintain security by instantly rotating usernames and passwords when needed. Because it’s available on Vinkius, you can connect this proxy intelligence to your existing AI client—whether that’s Claude or Cursor—and keep all your data collection steps in one conversation flow.
019d75bb-cbf1-7279-a1d8-51437c151b45 
Here's how it actually works
The bottom line is you talk to your agent about proxies; it uses this MCP to execute the commands.
Subscribe to this MCP on Vinkius.
Provide your IPRoyal API Access Token in the configuration.
Directly ask your AI client for an action, like 'What's my current traffic usage?' or 'Generate a proxy string for France.'
Who is this actually for?
Data scientists, security engineers, and automation developers need this. It's for anyone whose daily work involves high-volume data collection or maintaining complex digital access controls across multiple environments.
Needs to generate connection strings that accurately target specific countries while also making sure the session remains sticky.
Handles proxy credential rotation and whitelist management when deploying new scraping servers or updating access policies.
Runs large-scale data collection jobs, needing to monitor bandwidth usage via get_traffic before the budget runs dry.
What Changes When You Connect
Avoid manual checks. Instead of logging into a separate dashboard to check funds, just ask your agent for get_profile details. You know if you have enough budget before starting any big job.
Maintain security easily. If credentials are leaked, running change_credentials updates the username and password immediately. It's faster than changing them manually across all scripts.
Target specific regions reliably. Use list_countries to get the necessary country codes (like 'us' or 'de') then let your agent use generate_proxy_string to build a perfect connection string for that region.
Secure headless scrapers by whitelisting IPs. Rather than baking credentials into source code, you can authorize an IP using add_whitelist_ip, which keeps things cleaner and safer.
Monitor bandwidth usage in real-time. With residential proxies billed by traffic, running get_traffic prevents unexpected billing spikes when a crawl hits its limits.
See it in action
Large Scale Geo-Targeted Crawl
A data scientist needs to scrape competitor pricing only in Germany. They ask the agent to check availability first using get_availability, then request a proxy string for Germany, and finally run the job while monitoring traffic via get_traffic.
Security Audit & Cleanup
An ops engineer decommissioned an old server. They tell their agent to run remove_whitelist_ip using the former server's IP, ensuring that access is immediately cut off and preventing unauthorized use.
Credential Rotation After Breach
A developer suspects a credential leak for an important proxy order. They ask the agent to execute change_credentials right away, updating both the username and password without needing to restart their scripts.
Building a Robust Proxy Pipeline
An automation developer is building a new multi-country scraper. They first run list_countries to get all necessary region codes, then use these codes with generate_proxy_string to build the connection logic.
The honest tradeoffs
Assuming universal access
The user assumes that just because they have an active account, any IP can be used for scraping.
Always run list_whitelisted_ips first. If the required IP isn't listed, you must use add_whitelist_ip. Don't assume access; verify it.
Hardcoding credentials
Baking usernames and passwords directly into Python scripts makes them a major security risk if the code is ever exposed.
Use whitelisting instead. Run add_whitelist_ip to authorize your scraping server's IP, letting it connect without needing user/pass in the script.
Ignoring order details
When checking usage, the user just says 'How much traffic is left?' and gets a vague answer.
First, run list_orders to get the specific Order ID. Then use that ID when calling get_traffic for precise consumption data.
When It Fits, When It Doesn't
Use this MCP if your primary bottleneck is managing global proxy credentials or tracking bandwidth usage during scraping operations. It's built purely around infrastructure access control and connection string generation. Don't use it, though, if you just need to store general data records—that’s for a database MCP. Also, don't rely on this for business logic; it only handles the connection layer. Always remember that modifying credentials via change_credentials is high-risk and should be done only when absolutely necessary after confirming a leak.
Questions you might have
How do I check my current budget using get_profile? +
You ask your agent to get your profile details. It returns your overall account balance and status, letting you know if you can afford a large scraping run.
What is the difference between list_orders and list_whitelisted_ips? +
list_orders shows all purchased proxy batches (Residential, Datacenter), while list_whitelisted_ips only lists IPs authorized for direct connection without credentials.
How do I create a string for multiple countries using generate_proxy_string? +
You specify the list of target countries and whether you need sticky sessions. The agent combines all that information into one usable, dynamic proxy connection string.
Can I revoke an IP address with remove_whitelist_ip? +
Yes, running remove_whitelist_ip immediately revokes a specific IP's access to the proxy endpoints. This is how you secure it if the machine changes or gets decommissioned.
How do I use `add_whitelist_ip` to secure my scrapers? +
You authorize a new IP address by running add_whitelist_ip. This is key for security, letting your headless scrapers connect without needing the username and password in the source code.
What information does `list_countries` provide before I build a proxy string? +
list_countries gives you the necessary country codes and region identifiers (like 'us' or 'de'). You need this specific list to format complex, accurate geo-targeted connection strings.
I think my credentials leaked; how should I use `change_credentials`? +
Run change_credentials immediately. This updates the username and password for a given proxy order, which is critical for stopping unauthorized access right away.
Should I check IP availability using `get_availability` before running a crawl? +
Yes, call get_availability. It checks if IPs are actually available in your target region (by default residential) before you generate the proxy string and waste time.
Can I check how much bandwidth I've consumed for a specific proxy order? +
Yes. Use the get_traffic tool 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 tool 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 tool and specify the product (e.g. 'residential'). Your agent will return a live count of online proxies in the IPRoyal pool for each country.
We've already built the connector for IPRoyal. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 10 tools are live and waiting.
You're up and running in seconds.
Gemini Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.