# Webshare MCP MCP

> Webshare manages residential and datacenter proxies, rotation settings, and authorized IPs through conversation. Use this MCP to get real-time stats on bandwidth consumption, list all assigned proxy credentials, or instantly request replacements for blocked IPs. It gives you full control over your entire proxy infrastructure without logging into a separate dashboard.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** proxy-management, ip-rotation, residential-proxies, datacenter-proxies, network-security, ip-whitelisting

## Description

You can manage complex proxy pools directly from your agent. Need to scrape data across different geographic locations? This MCP lets you audit which IP addresses are whitelisted and monitor the health status of every assigned residential or datacenter IP, including port numbers and credentials. It also tracks exactly how much bandwidth you've used this month compared to your plan limits. When an IP gets flagged or blocked mid-run, you don't have to stop; you just ask for a replacement, and it handles the request. Because credentials are so sensitive, all key usage passes through Vinkius's zero-trust proxy—your keys never sit on disk. This makes managing your entire proxy pool safer than ever.

## Tools

### authorize_new_ip
Adds a new IP address to the list of IPs allowed to use your proxies.

### export_proxy_list
Creates a temporary token so you can download your entire proxy list in one shot.

### get_account_profile
Gets your user profile, including how much bandwidth and what the plan limits are.

### get_bandwidth_stats
Retrieves historical stats on bandwidth usage and request success rates over time.

### get_proxy_configuration
Shows the current settings for proxy rotation and backbone network setup.

### get_replacement_quota
Checks how many times you can request a replacement IP during this billing cycle.

### list_authorized_ips
Lists all IPs that have been authorized to use your proxies without needing a password.

### list_proxies
Paginates and lists every assigned proxy IP with its port, credentials, and current health status.

### request_proxy_replacement
Asks for an immediate replacement of a specific proxy IP, provided you have quota left.

### revoke_ip_authorization
Removes a specified IP address from the list of authorized IPs.

## Prompt Examples

**Prompt:** 
```
List my active proxies and their health status.
```

**Response:** 
```
I found 10 active proxies in your pool. They are all currently 'HEALTHY'. The top ones are 1.2.3.4 (Port: 8080), 5.6.7.8 (Port: 8080), and 9.10.11.12 (Port: 8080). Would you like to see the credentials for these?
```

**Prompt:** 
```
Authorize the IP address 192.168.1.100 for my proxy pool.
```

**Response:** 
```
Success! I have added 192.168.1.100 to your Webshare authorized IP whitelist. This machine can now access your proxies without password authentication.
```

**Prompt:** 
```
What are my bandwidth statistics for this month?
```

**Response:** 
```
You have consumed 45.2 GB of your 100 GB monthly quota. You have approximately 54.8 GB remaining. You've made 1.2 million requests with a 98.5% success rate. Would you like to see a breakdown by day?
```

## Capabilities

### List Proxy Credentials
Get a full list of every assigned IP, port, and credential pair in your current proxy pool.

### Whitelist IPs
Authorize new IP addresses instantly so they can access your proxies without needing passwords.

### Check Usage Limits
Retrieve your account profile, showing remaining bandwidth and plan limits before you start a large data task.

### Request Replacement IPs
Immediately ask for a replacement IP when an address gets blocked or flagged during scraping.

### View Network Settings
Retrieve the current settings for proxy rotation and backbone network configurations to confirm your crawlers are set up correctly.

## Use Cases

### Scraping a competitor's site
The agent runs into multiple blocked IP errors. Instead of failing, you check the quota with `get_replacement_quota`, then tell it to use `request_proxy_replacement` until the block clears.

### Auditing a new machine's access
Before connecting any new server, you run `list_authorized_ips` and manually verify that the IP is on the approved list. If it's not there, you use `authorize_new_ip`.

### Optimizing a scraping pipeline
You need to know if your current proxy rotation settings are correct. You call `get_proxy_configuration` and review the backbone network details before running the full job.

### Billing and Capacity Planning
A manager needs a report on usage. They ask for bandwidth statistics, triggering the retrieval of data via `get_bandwidth_stats`, which shows consumption against the plan limits found in `get_account_profile`.

## Benefits

- Stop guessing if an IP is blocked. You can check your quota by running `get_replacement_quota` to know exactly how many replacements you have left for the cycle.
- Never manually log into a dashboard just to see what's going on. You can get real-time stats, including bandwidth usage and success/failure rates, using `get_bandwidth_stats`.
- Need to grant access quickly? Use `authorize_new_ip` or, if the IP is no longer needed, use `revoke_ip_authorization`. It’s all done in chat.
- When your scraper hits a bad endpoint, you don't stop. You tell the agent to request an immediate replacement with `request_proxy_replacement` and keep going.
- Get a clean inventory of everything: run `list_proxies` for all IPs, or use `export_proxy_list` to download your full credentials list in one go.

## How It Works

The bottom line is: it turns manual dashboard clicking into direct chat commands.

1. First, connect this MCP using your Webshare API Key.
2. Next, ask your agent to perform a task, like 'List all proxies and their health status.'
3. Finally, the agent returns the current operational data—the list of IPs, ports, or usage stats you needed.

## Frequently Asked Questions

**How do I check if my proxy credentials are still valid with the Webshare MCP?**
You run 'list proxies'. This tool lists every assigned IP along with its current port, credentials, and live health status.

**What is the best way to track bandwidth usage using the Webshare MCP?**
Use 'get bandwidth stats'. It pulls historical data on consumption and success rates. This helps you plan big scraping jobs accurately against your overall limit.

**If an IP gets blocked, how do I fix it with the Webshare MCP?**
You can run 'request proxy replacement'. The agent will attempt to cycle out the bad IP for a fresh one, provided you still have quota available.

**Can I add an authorized IP address using the Webshare MCP?**
Yes. Use 'authorize new ip' and provide the target IP. This grants access without requiring manual intervention on the dashboard.

**Using the `get_account_profile` tool, how can I verify my current plan limits and remaining bandwidth?**
You get your account details immediately. The MCP returns your full plan limits and spending status so you know exactly what quota you've used before running large-scale tasks.

**What information does the `get_proxy_configuration` tool provide regarding proxy rotation settings?**
It gives you all the technical operational settings. You see the active rotation policies, backbone network details, and how your crawlers are configured to run correctly.

**Using the `export_proxy_list` tool, how do I get a comprehensive download of all my proxy IPs?**
The MCP generates temporary tokens for you. You use these tokens to download your entire current proxy pool in one single request, which is much faster than manual methods.

**If an IP address is compromised, how does the `revoke_ip_authorization` tool remove it from my whitelist?**
You supply the unique IP ID. The MCP instantly removes that specific address from your authorized list, immediately blocking its ability to access your proxy network.