# Webshare MCP for AI Agents AI Agent Connect

> Webshare MCP lets you manage your proxy infrastructure through your AI client. It handles residential and datacenter proxies, rotation settings, and IP whitelisting. You can check your bandwidth, swap out blocked IPs, and export lists without jumping back into the Webshare dashboard. It connects your account to your agent so you can manage your proxy pool via natural conversation, keeping your data pipelines running without manual overhead.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_3cBcuAZTycLYsWJR2auoFMct8qTnpvb3JtvGEAiL/ai-agent-connect
- **Tags:** proxy-management, ip-rotation, residential-proxies, datacenter-proxies, network-security, ip-whitelisting

## Description

This Connector connects your Webshare account to any AI agent and takes full control of your proxy infrastructure through natural conversation. It handles the heavy lifting of proxy management, from listing residential and datacenter IPs to auditing your whitelist of authorized addresses. You can check your bandwidth consumption and request success rates directly from your agent, ensuring your scrapers stay on track. If an IP gets flagged, you can request an immediate replacement within your account quota. It even lets you generate temporary tokens to export your entire list in one go. Because Vinkius hosts this, you can plug it into your existing workflow and treat your AI like a dedicated proxy administrator. No more manual logging into the Webshare dashboard to whitelist an IP or cycle a proxy. Instead of clicking through complex menus and copy-pasting addresses between tabs, you just tell your agent what needs to happen. Whether you're managing a small pool for a research project or a massive network for a data pipeline, this setup keeps everything organized in one place. You get to stay in your flow while the agent handles the tedious parts of network configuration.

## Tools

### export_proxy_list
Generates a temporary token to download your entire proxy list. This is perfect for moving large amounts of data into other tools.

### get_account_profile
Retrieves your Webshare user profile, including plan limits and quotas. Use this to see how much bandwidth you have left.

### get_proxy_configuration
Retrieves current proxy rotation and backbone network settings. It ensures your crawlers are using the right network path.

### get_bandwidth_stats
Retrieves historical bandwidth and request statistics. This helps you track your success rates and costs over time.

### get_replacement_quota
Checks the available proxy replacement limits for the current cycle. It helps you know how many refreshes you have left.

### list_authorized_ips
Lists all IP addresses authorized to use proxies without password authentication. Use this to audit your current whitelist.

### list_proxies
Lists all assigned proxy IPs with their ports, credentials, and health status. This gives you a live view of your proxy pool.

### revoke_ip_authorization
Removes an IP address from the authorized whitelist using its unique ID. Use this to clean up old server permissions.

### request_proxy_replacement
Requests an immediate replacement for a specific proxy IP. This is your go-to for swapping out blocked or failing nodes.

### authorize_new_ip
Whitelists a new IP address for proxy access. It lets you grant your servers access without needing passwords.

## Prompt Examples

**Prompt:** 
```
How much bandwidth do I have left on my plan?
```

**Response:** 
```
### Account Status

*   **Current Plan:** Standard Data Package
*   **Total Quota:** 100 GB
*   **Consumed:** 45.2 GB
*   **Remaining:** **54.8 GB**

Your usage is currently within normal limits for this month. Would you like me to pull a breakdown of your daily consumption?
```

**Prompt:** 
```
List my proxies and tell me which ones are unhealthy.
```

**Response:** 
```
### Proxy Pool Health

I've checked your active proxies. Here is the status of your pool:

| IP Address | Port | Status |
| :--- | :--- | :--- |
| 1.2.3.4 | 8080 | **HEALTHY** |
| 5.6.7.8 | 8080 | **HEALTHY** |
| 9.10.11.12 | 8080 | **FLAGGED** |

I found one unhealthy node (9.10.11.12). Should I request a replacement for it?
```

**Prompt:** 
```
Authorize 192.168.1.50 for my proxy pool.
```

**Response:** 
```
✅ **Success!**

I have added **192.168.1.50** to your Webshare authorized IP whitelist. This machine can now access your proxies without password authentication. Is there anything else you need to configure?
```

## Capabilities

### List proxy IPs and health
See all your assigned proxy IPs along with their ports, credentials, and live health status.

### Whitelist new server IPs
Grant new server addresses access to your proxies without needing extra passwords.

### Check rotation settings
Retrieve your current proxy rotation rules and backbone network configurations.

### Monitor bandwidth usage
Track your historical bandwidth consumption and request success rates in real-time.

### Swap out blocked IPs
Request an immediate replacement for a specific proxy IP that has been flagged.

### Check account quotas
View your plan limits and remaining bandwidth before starting large scale tasks.

### Export proxy lists
Generate a temporary token to download your entire proxy list in a single request.

## Use Cases

### Blocked IP recovery
A scraper hits a wall because an IP is flagged. The user tells the agent to use request_proxy_replacement to get a fresh one.

### New Server Onboarding
A dev spins up a new scraping node. They ask the agent to authorize_new_ip so the node can start working immediately.

### Bandwidth Auditing
A manager wants to know if they're overspending. They ask the agent to pull get_bandwidth_stats for the last 30 days.

### Proxy Pool Health Check
A researcher needs to know which proxies are alive. They ask the agent to list_proxies to see the health status of the whole pool.

## Benefits

- Stop manually whitelisting IPs by using authorize_new_ip to grant server access instantly through your AI client.
- Keep your scraping pipelines running by using request_proxy_replacement to swap out blocked IPs without touching the dashboard.
- Monitor your costs and limits in real-time with get_bandwidth_stats and get_account_profile to avoid unexpected overages.
- Ensure your crawlers are on the right network by checking rotation settings with get_proxy_configuration.
- Audit your security posture by listing and revoking authorized IPs with list_authorized_ips and revoke_ip_authorization.
- Bulk move your data with export_proxy_list to get a full list of your proxies in a single request.

## How It Works

The bottom line is you turn your AI agent into a dedicated proxy administrator that handles the tedious network configuration for you.

1. Subscribe to the Webshare MCP on Vinkius
2. Provide your Webshare API Key to your AI client
3. Manage your proxy pool via chat or command

## Frequently Asked Questions

**Does the Webshare MCP help with web scraping?**
Yes, it helps manage the proxy infrastructure needed for scraping. You can use it to handle IP rotation, whitelist new scraping nodes, and swap out blocked IPs automatically.

**Can I use this to see if my proxies are working?**
Yes, your AI agent can pull live health statuses for your entire proxy pool. This lets you quickly identify and replace nodes that are no longer responding.

**How do I whitelist a new server IP with Webshare MCP?**
You can simply tell your AI client to authorize a specific IP address. The Connector will update your whitelist instantly so your new server can start working without passwords.

**Can it help me avoid being blocked by websites?**
Yes, by using the replacement tool, you can have your agent automatically swap out IPs that get flagged or blocked, helping you maintain a consistent connection.

**Does this work with other proxy providers?**
No, this Connector is specifically built for the Webshare proxy network. You would need a different MCP for other providers.

**Can I see my bandwidth usage through the AI?**
Yes, your agent can retrieve your historical bandwidth stats and your current remaining quota, so you can monitor your costs in real-time.

**Can I authorize my current IP address to use proxies via chat?**
Yes. The `authorize_new_ip` tool allows you to immediately whitelist a new IPv4 address in your Webshare account, so you can start using your proxies from that machine without a password.

**How do I replace a proxy that has been blocked by a target website?**
Use the `request_proxy_replacement` tool and provide the unique `proxy_id`. Your agent will instruct Webshare to cycle that specific IP for a new one, subject to your account's replacement quota.

**Can I check how much bandwidth I have left this month?**
Absolutely. The `get_account_profile` tool provides real-time info on your plan limits and remaining bandwidth quota, so you can monitor consumption and avoid interruptions.