# IPRoyal (Proxy Services) MCP for AI Agents AI Agent Connect > IPRoyal (Proxy Services) MCP gives you direct control over your proxy infrastructure. It lets you monitor traffic, rotate credentials, and manage whitelisted IPs through a natural conversation with your AI agent. It's built for anyone who needs to manage large-scale web scraping or geo-targeted data collection without the friction of manual dashboard management. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_ufj8i7Qawm5R8Yoequxc3gAiMLIBTNP2yijAnz5x/ai-agent-connect - **Tags:** proxy-management, web-scraping, traffic-monitoring, credential-rotation, geo-targeting ## Description The IPRoyal (Proxy Services) MCP gives you direct control over your proxy infrastructure. Stop jumping between browser tabs to check your proxy balances or rotate credentials while you're trying to debug a scraper. It lets you handle your entire network through a simple chat interface. You can ask your agent to find the right country codes for a new scraping run, generate connection strings with sticky sessions, or see exactly how much bandwidth you have left on a specific order. It turns your proxy management into a conversation rather than a series of manual clicks. You'll find it's much faster to manage whitelists or swap out credentials on the fly when you're in the middle of a deployment. Because Vinkius handles the connection, you just need your API key to get started. This setup removes the friction of manual account management, letting you focus on the actual data you're trying to collect. You can quickly audit your account status, verify regional availability, and ensure your headless scrapers stay authenticated without exposing sensitive keys in your source code. It's about moving from manual maintenance to automated oversight. ## Tools ### get_availability Check if a target region has enough residential IPs. Use this to verify capacity before starting a crawl. ### list_countries Get a list of supported country codes and region identifiers. Use these to build your geo-targeted proxy strings. ### change_credentials Update the username and password for a specific proxy order. This is perfect for rotating keys if a leak is suspected. ### list_whitelisted_ips See which IP addresses are currently allowed to connect without a username or password. Use this to audit your access. ### list_orders Retrieve all active residential and datacenter proxy orders. This gives you the IDs needed for traffic lookups. ### get_profile Get your current account balance and profile details. Use this to make sure you have enough funds for a big run. ### generate_proxy_string Create a dynamic geo-targeted proxy string. You can specify countries and sticky sessions in the request. ### remove_whitelist_ip Revoke an IP from your whitelist. Use this to clean up access once a scraping server is decommissioned. ### add_whitelist_ip Authorize a specific IP address for IPRoyal proxy access. This keeps your scraper credentials out of your source code. ### get_traffic Check the precise bandwidth consumption for a specific order. This helps prevent unexpected fund depletion. ## Prompt Examples **Prompt:** ``` Check my IPRoyal account balance ``` **Response:** ``` I've retrieved your profile details. Your current account balance is **$45.20 USD**. **Account Status:** Active **Email:** alex@example.com Would you like to see your active proxy orders? ``` **Prompt:** ``` How much traffic have I used for order ID '123456'? ``` **Response:** ``` For order **123456** (Residential Proxies), here is your current usage: * **Consumed:** 12.45 GB * **Remaining:** 37.55 GB Would you like to rotate the credentials for this order? ``` **Prompt:** ``` Generate a proxy connection string for Germany with sticky session ``` **Response:** ``` Generating proxy string... For **Germany (DE)** with a **sticky session**, your connection string is: `geo.iproyal.com:10000:username_country-de_session-abc123:password` You can use this directly in your scraping script. ``` ## Capabilities ### Monitor account balance Check your current funds and profile details to ensure you have enough credit for large scraping jobs. ### Track bandwidth usage Get real-time statistics on how much traffic your residential or datacenter orders have consumed. ### Rotate proxy credentials Update usernames and passwords for specific orders instantly to keep your access keys fresh. ### Verify regional availability Check which countries have available IPs before you start a geo-targeted crawl. ### Manage IP whitelists Authorize or revoke specific IP addresses to allow credential-free access for your servers. ### Generate connection strings Create dynamic proxy strings with country routing and sticky session support. ## Use Cases ### Geo-targeted data collection A researcher needs to scrape data from 10 different countries. They ask the agent to use list_countries and generate_proxy_string to create the correct connection list. ### Securing headless scrapers A developer wants to move away from hardcoding credentials. They use add_whitelist_ip to authorize their server's IP for direct access. ### Emergency credential rotation An engineer suspects a proxy key leak. They ask the agent to use change_credentials to update the username and password for all active orders. ### Bandwidth monitoring An automation lead needs to know if a scraping job is over budget. They use get_traffic to see the exact GB consumed for a specific order ID. ## Benefits - Stop manual credential entry by using add_whitelist_ip to authorize your server IPs. - Prevent mid-scrape failures by checking your balance with get_profile before starting. - Keep your access keys secure by rotating them instantly with change_credentials. - Avoid wasted bandwidth by checking regional capacity with get_availability. - Generate correct geo-targeted strings for any country using generate_proxy_string. - Monitor your costs in real-time with get_traffic to see exact order consumption. ## How It Works The bottom line is you get a conversational way to manage your proxy network without leaving your AI client. 1. Subscribe to this Connector via the Vinkius Marketplace 2. Provide your IPRoyal API Access Token in the configuration 3. Ask your AI client to check balances, rotate keys, or generate proxy strings ## Frequently Asked Questions **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` 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.