# Residential Proxies MCP > Residential Proxies: Route your web traffic through residential IP addresses globally. This server lets you programmatically manage massive proxy pools for data collection, testing, and research. You pull geo-specific IPs to bypass anti-bot measures and avoid captchas when scraping or running tests worldwide. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** proxy-rotation, ip-anonymity, data-collection, web-automation, scraping-infrastructure, network-security ## Description **Residential Proxies: Global IP Management for Scraping and Testing** You connect your AI client to this server when you need full control over massive pools of residential IPs. This isn't some generic proxy list; it's a programmatic way to route all your web traffic through real, geo-specific addresses worldwide. When you pull data or run tests across different regions, you'll hit anti-bot measures and captchas. This server lets your agent handle the complex logic of bypassing those blocks by managing proxies like a network service. **Checking Status and Scale** You always wanna know if the connection is solid before you start pulling data. You use `check_proxy_status` to verify the current operational status of your entire Residential Proxies API connection; it tells you if the whole thing's up or not. If you need a quick sense of the size of the operation, `get_proxy_count` gives you the exact total number count of every available proxy address in your pool. **Global Overview and Specific Counts** Want to know what's out there without listing everything? You run `get_multi_country_proxies`, and it returns an overall summary with sample proxy counts across several countries at once. Need a full picture of every single address you own? Just call `list_proxies`. If that's too much data, you can use `get_proxy_count` to get the total number or `get_proxies_limited` if you only need to sample a small batch for testing. You also have `get_proxies_by_country`, which lets your agent pull a list of proxies filtered exactly by any country code, like US or GB. **Targeting Key Markets** You don't always need the whole globe; sometimes you just gotta hit specific spots. For the United States, you run `get_us_proxies` to get a working list of residential proxies there. If you're headed to Germany, use `get_de_proxies`. Need Brazil? `get_br_proxies` pulls that list for you. For the UK, `get_uk_proxies` gets those specific addresses. You can also pull US IPs using `get_us_proxies`, or German ones with `get_de_proxies`; these dedicated tools make sure you get exactly what you asked for in those major markets. **Summary of Use Cases** * **Verification:** If your connection is acting up, use `check_proxy_status` to confirm the API link's health. * **Broad Scope:** To see a general idea of global availability, run `get_multi_country_proxies`. * **Total Pool Check:** You can get the exact count with `get_proxy_count`, or list every single address in your entire pool using `list_proxies`. * **Targeted Retrieval:** If you're scraping data from, say, France, you use `get_proxies_by_country` and provide 'FR'. You can also pull proxies for the US via `get_us_proxies`, or Germany with `get_de_proxies`. * **Testing:** If you just need to check a few IPs before committing, you run `get_proxies_limited` to sample a small batch instead of pulling hundreds. This setup lets your agent manage the complexity. You tell your client what data you're after—a list of working proxies in Germany, or maybe just 5 addresses for testing—and it runs the necessary tool calls using this server. It’s designed to give you clean, operational IP strings without any guesswork. ## Tools ### check_proxy_status Verifies the current operational status of your entire Residential Proxies API connection. ### get_proxy_count Returns the total number count of all available residential proxies in your pool. ### get_br_proxies Retrieves a list of working residential proxies specifically located in Brazil (BR). ### get_proxies_by_country Pulls a list of residential proxies filtered by any specific country code you provide (e.g., US, GB). ### get_de_proxies Retrieves a list of working residential proxies specifically located in Germany (DE). ### get_proxies_limited Gets a small batch of proxies, useful when you only need to test or sample the service. ### get_uk_proxies Retrieves a list of working residential proxies specifically located in the United Kingdom (UK). ### get_us_proxies Retrieves a list of working residential proxies specifically located in the United States (US). ### list_proxies Lists every single available residential proxy address currently in your entire pool. ### get_multi_country_proxies Returns an overall summary, including sample proxy counts for several countries at once. ## Prompt Examples **Prompt:** ``` List 10 working residential proxies from the USA. ``` **Response:** ``` I've retrieved the proxies. I found 10 high-fidelity working IPs from the US, formatted as IP:Port:User:Pass. Would you like the detailed latency metadata for any of them? ``` **Prompt:** ``` Show available residential proxies for country code 'GB'. ``` **Response:** ``` Accessing proxy intelligence... For country code GB, I've identified 15 high-fidelity working residential proxies. I've retrieved the technical metadata for your scraping session. Need help monitoring the availability status? ``` **Prompt:** ``` Check my RapidAPI status and proxy usage metrics. ``` **Response:** ``` Operational monitoring complete! Your API connection to RapidAPI is active and healthy. Your account has processed 1,000 high-fidelity proxy requests this month. Shall I retrieve the detailed usage breakdown? ``` ## Capabilities ### Pull specific country IPs You can ask the agent for proxy lists filtered exactly by a country, like Germany or Brazil. ### Get comprehensive global views The tool returns counts and sample proxies across multiple countries at once, giving you an overview of your whole pool. ### Check the entire proxy status You verify if the API connection is working by checking the overall operational status of your proxy account. ### Limit and sample IPs If you just need to test a few addresses, you can pull only a limited number of proxies instead of listing them all. ### Count total availability You get the exact total number of available proxy addresses in your entire pool. ## Use Cases ### Monitoring Website Health A researcher needs to check if their target websites are accessible from both the US and Germany today. They ask their agent: 'What's the status in the US, and can I get some DE proxies?' The agent first uses `get_us_proxies`, then runs `get_de_proxies`, giving them instant confirmation on availability for a multi-market report. ### Debugging Scraper Failures A data engineer's script keeps failing with 'Rate Limit Exceeded.' They instruct their agent to first use `get_proxy_count` to check the pool size, then run `list_proxies` to manually review a few IPs. This helps them pinpoint if the issue is IP saturation or bad rotation. ### Preparing for Global Launch A growth lead needs to validate their data extraction pipeline across three regions (UK, US, and GB). They use `get_proxies_by_country` multiple times, then ask the agent to combine the results via a custom script query. This saves them from juggling three different dashboards. ### Quickly Testing New Targets A developer needs only five IPs for a quick test run before writing code. Instead of listing everything, they use `get_proxies_limited`. This is fast and efficient, allowing them to confirm connectivity without hitting API quotas. ## Benefits - You maintain a perfect audit trail of your scraping sessions and bypass bot detection using high-fidelity rotating IPs. Simply ask the agent to rotate, and it handles the complexity. - Get instant operational reports by running `check_proxy_status` through your AI client, confirming API connectivity before any data pull starts. - Avoid manual country filtering. The `get_proxies_by_country` tool lets you target IPs from specific markets (like US or DE) with a single command. - You get an immediate overview of your entire infrastructure by running `get_multi_country_proxies`, letting you plan data collection across borders. - When you only need to test, the `get_proxies_limited` tool saves bandwidth and time. You pull a small sample instead of listing thousands of IPs. ## How It Works The bottom line is that your AI client acts as a dedicated network coordinator, running complex proxy requests through simple conversation. 1. First, subscribe to this MCP Server and retrieve your RapidAPI Key. 2. Next, connect your AI client (Claude, Cursor, etc.) using the key. When you need IPs, tell the agent what criteria to use—like 'I need proxies for Brazil.' 3. The agent executes the tool call, pulls the list of IPs, and presents them directly in the chat window. ## Frequently Asked Questions **How do I check if my proxy API connection is working using check_proxy_status?** Just tell your agent to run `check_proxy_status`. The tool immediately verifies the connection health and gives you a clear 'active' or 'failed' status, so you know if you can proceed with data collection. **Can I get proxies for multiple countries using get_proxies_by_country?** Yes. You specify the country codes (like US, GB, and DE) in your prompt to the agent. The tool then filters and retrieves proxy addresses from all those specified locations. **What's the best way to get a comprehensive overview of my IPs?** Use `get_multi_country_proxies`. This tool pulls a summary, giving you counts and sample proxies across multiple regions at once. It’s perfect for initial planning. **Do I have to use get_us_proxies every time I need US IPs?** No. While `get_us_proxies` works, you can also use the general tool `get_proxies_by_country` and specify 'US' as the filter. Both achieve country-specific results. **How do I use get_proxies_limited to test a small sample before running a full scrape?** It retrieves a limited batch of working proxies. This lets you quickly validate connectivity and check latency without draining your entire proxy pool or risking rate limits on large data pulls. **Is it better to run get_proxy_count or list_proxies if I just need an idea of the total scale?** Use `get_proxy_count`. It sends a minimal request and returns only the number, which is much faster than calling `list_proxies`, which pulls all available IP details. **What specific metadata does get_multi_country_proxies provide for international planning?** It provides a summary count and sample proxies per country. This gives you an immediate, high-level overview of availability across multiple regions without having to pull full technical data for every single IP. **If I run get_br_proxies and receive an error, what is the first troubleshooting step?** First, verify your API credentials using `check_proxy_status`. If that connection check succeeds, the issue is likely a temporary service outage or rate limit, not your setup. **How do I find my RapidAPI Key?** Log in to [**RapidAPI**](https://rapidapi.com/), navigate to the AppVidLab Residential Proxies API page, and copy your unique API Key from the endpoints section. **Can I target specific countries via AI?** Yes! The `list_working_proxies` tool supports a `country_code` parameter to retrieve high-fidelity proxies from specific locations. **Are the proxies rotating?** Yes, the API provides high-fidelity residential IP strings that rotate to ensure anonymity and maintain technical scraping performance.