Residential Proxies Connector for AI agents.
10 live capabilities
Manage global residential IP pools and bypass web blocks automatically.
Waiting for input…
Why people use Residential Proxies
Residential Proxies : Bypassing Geo-Blocks in Web Scraping
With this Connector, you just tell your agent to get you proxies from a specific country. It pulls the data, checks the status, and feeds it into your workflow. You stop managing infrastructure and start looking at the actual data you need.
What Vinkius changes
You get a hands-off way to manage global residential IPs without leaving your AI chat window.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Bypassing regional e-commerce blocks
A scraper needs to pull prices from a French site.
- Real-world use case 02
Automated market research
A growth lead wants to see what products are trending in Brazil.
- Real-world use case 03
Infrastructure health monitoring
A data engineer wants to make sure their proxy subscription is active.
Complete set · 10capabilities
The complete Residential Proxies capability set.
These are the exact actions your AI can choose when you ask it to work with Residential Proxies.
01—04
4 capabilities in this set.
Part of 10 available through Residential Proxies.
- 01 Capability
Get proxies by country
Filter your proxy list by specific country codes like US, GB, or DE. Use this to target specific geographic regions for your scraping tasks.
- 02 Capability
Get de proxies
Get residential proxies from Germany. This helps you access German-specific web content easily.
- 03 Capability
Get br proxies
Get residential proxies specifically from Brazil. This is useful for targeting Brazilian users or content.
- 04 Capability
Get proxies limited
Get a small sample of available proxies. This is perfect for quick smoke tests or verifying your connection.
05—07
3 capabilities in this set.
Part of 10 available through Residential Proxies.
- 05 Capability
Get uk proxies
Get residential proxies from the United Kingdom. Use this to simulate traffic from the UK.
- 06 Capability
Get us proxies
Get residential proxies from the United States. This is the standard way to get US-based residential traffic.
- 07 Capability
List proxies
List every residential proxy currently available in your pool. This gives you a full view of your active assets.
08—10
3 capabilities in this set.
Part of 10 available through Residential Proxies.
- 08 Capability
Get multi country proxies
Get a summary of proxy counts and samples across multiple countries. This helps you see your global coverage at a glance.
- 09 Capability
Check proxy status
Verify that your proxy API is online and responding correctly. Use this to ensure your connection is healthy.
- 10 Capability
Get proxy count
Get the total number of active proxies in your account. This helps you monitor your subscription limits.
Set up in minutes
One URL. Then ask Residential Proxies to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Residential Proxies 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_aRK8G2KuhEE0zuCd8uODpUZ2EQu6zElDWdu2E5sQ/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 Residential Proxies, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Residential Proxies for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_aRK8G2KuhEE0zuCd8uODpUZ2EQu6zElDWdu2E5sQ/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 Residential Proxies URL.
- Step 03
Save and start
Save the connection and enable Residential Proxies in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"residential-proxies": {
"url": "https://edge.vinkius.com/vk_preview_aRK8G2KuhEE0zuCd8uODpUZ2EQu6zElDWdu2E5sQ/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 Residential Proxies
Open Agent mode in chat and ask: "Using Residential Proxies, help me...". 10 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"residential-proxies": {
"url": "https://edge.vinkius.com/vk_preview_aRK8G2KuhEE0zuCd8uODpUZ2EQu6zElDWdu2E5sQ/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 Residential Proxies
Ask Copilot: "Using Residential Proxies, help me...". 10 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"residential-proxies": {
"url": "https://edge.vinkius.com/vk_preview_aRK8G2KuhEE0zuCd8uODpUZ2EQu6zElDWdu2E5sQ/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 Residential Proxies
Open Cascade and ask: "Using Residential Proxies, help me...". 10 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"residential-proxies": {
"url": "https://edge.vinkius.com/vk_preview_aRK8G2KuhEE0zuCd8uODpUZ2EQu6zElDWdu2E5sQ/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 Residential Proxies
Ask Cline: "Using Residential Proxies, help me...". 10 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add residential-proxies --transport http "https://edge.vinkius.com/vk_preview_aRK8G2KuhEE0zuCd8uODpUZ2EQu6zElDWdu2E5sQ/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 Residential Proxies
Ask Claude: "Using Residential Proxies, show me...". 10 tools are ready
Where the request belongs
Work Residential Proxies can move forward.
This is for the data engineer tired of manual IP rotation and the web scraper who needs to bypass geo-blocks to get clean data.
Data Engineer
Automates data collection pipelines by requesting specific proxy pools for different regions.
Web Scraper
Bypasses bot detection and captchas while gathering product or price data from international sites.
Growth Lead
Runs automated market research and testing across multiple countries without manual configuration.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsIPRoyal (Proxy Services)
Manage proxies via IPRoyal. monitor traffic, rotate credentials, and manage whitelisted IPs.
Webshare
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.
AdGuard Home
Manage your AdGuard Home instance. control protection, DNS settings, and filtering rules directly from any AI agent.
IPGeolocation.io
Real-time IP geolocation, security intelligence, and timezone data. identify locations, detect VPNs, and manage timezones directly via AI.
ScraperAPI
Equip your AI agent with proxy rotation and headless browsers to extract HTML, Google SERPs, and Amazon data at scale.
Bring your own AI
Change the model, client or framework. Keep Residential Proxies 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 Residential Proxies.
The practical details behind the request, access and result.
How does the Residential Proxies MCP help with web scraping?
It helps by providing high-fidelity residential IPs that look like real users. This allows your agent to bypass bot detection and geo-blocks that usually stop standard scraping capabilities.
Can I use the Residential Proxies MCP to target specific countries?
Yes, you can request proxies for specific regions like the US, UK, Germany, or Brazil. Your agent can filter the pool and give you exactly what you need for that specific location.
What happens if my proxies aren't working?
You can use the status check capability to verify your connection instantly. If something is down, your agent can help you find a fresh list of working IPs from your pool.
Is the Residential Proxies MCP good for large data sets?
It's designed for it. By automating the rotation and fetching of IPs, you can run large-scale data collection without having to manually manage thousands of proxy strings.
How do I get my API key for the Residential Proxies MCP?
You can get your key from your RapidAPI dashboard under the AppVidLab Residential Proxies section. Once you have it, just plug it into your agent's configuration.
Can my AI agent rotate proxies automatically?
Yes, your agent can call the list and country capabilities to fetch new IPs for every session. This ensures your scraping tasks stay under the radar and maintain high success rates.
How do I find my RapidAPI Key?
Log in to RapidAPI, 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 capability 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.
One connection away
Give your agent a direct line to Residential Proxies.
Connect Residential Proxies once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available