Webshare MCP. Manage Your Entire Proxy Pool From Chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
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.
What your AI agents can do
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 a full list of every assigned IP, port, and credential pair in your current proxy pool.
Authorize new IP addresses instantly so they can access your proxies without needing passwords.
Retrieve your account profile, showing remaining bandwidth and plan limits before you start a large data task.
Immediately ask for a replacement IP when an address gets blocked or flagged during scraping.
Retrieve the current settings for proxy rotation and backbone network configurations to confirm your crawlers are set up correctly.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Webshare: 10 Tools for Proxy Control
These tools let you manage every aspect of your proxy pool—from whitelisting new IPs to retrieving detailed usage and health statistics.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Webshare on Vinkius019d7621authorize new ip
Adds a new IP address to the list of IPs allowed to use your proxies.
019d7621export proxy list
Creates a temporary token so you can download your entire proxy list in one shot.
019d7621get account profile
Gets your user profile, including how much bandwidth and what the plan limits are.
019d7621get bandwidth stats
Retrieves historical stats on bandwidth usage and request success rates over time.
019d7621get proxy configuration
Shows the current settings for proxy rotation and backbone network setup.
019d7621get replacement quota
Checks how many times you can request a replacement IP during this billing cycle.
019d7621list authorized ips
Lists all IPs that have been authorized to use your proxies without needing a password.
019d7621list proxies
Paginates and lists every assigned proxy IP with its port, credentials, and current health status.
019d7621request proxy replacement
Asks for an immediate replacement of a specific proxy IP, provided you have quota left.
019d7621revoke ip authorization
Removes a specified IP address from the list of authorized IPs.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Webshare, then connect any of our 4,900+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,900+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Webshare. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Handling IP Access and Usage Limits
Today, managing proxy credentials means bouncing between a dozen dashboards. You check the usage dashboard for bandwidth, then you navigate to the 'Authorized IPs' tab if someone needs access, and finally, you find the list of active proxies—all requiring manual logins, copy-pasting IDs, and clicking through multiple tabs just to get a single status report.
With this MCP, those steps vanish. You ask your agent for what you need, whether it’s checking usage with `get_bandwidth_stats` or finding the current list of IPs using `list_proxies`. The AI handles the multi-step process and gives you one clean answer.
Managing IP Authorization
Before, adding a new client's machine meant logging in and manually ticking a box to whitelist their entire subnet. Removing an old system was the same tedious process—you had to find its unique ID and uncheck it from the authorization list.
Now, you just tell your agent which IP needs access or which one should lose it. The MCP runs `authorize_new_ip` or `revoke_ip_authorization`, completing complex infrastructure tasks in a single chat interaction.
What you can do with this MCP connector
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.
019d7621-ae4e-7289-aff8-58537331e266 
How Webshare MCP Works
- 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.
The bottom line is: it turns manual dashboard clicking into direct chat commands.
Who Is Webshare MCP For?
This MCP is for the data architect who hates repetitive setup work. It's for anyone whose job involves high-volume, geographically diverse web scraping or API testing where IP rotation and access management are core to success.
Automates proxy management and whitelisting of IPs required for large-scale data pipelines.
Monitors bandwidth usage, checks quota limits, and manages the underlying proxy infrastructure through chat commands.
Audits authorized IP lists and cycles endpoints for enhanced anonymity when testing access points.
What Changes When You Connect
- Stop guessing if an IP is blocked. You can check your quota by running
get_replacement_quotato 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_ipor, if the IP is no longer needed, userevoke_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_replacementand keep going. - Get a clean inventory of everything: run
list_proxiesfor all IPs, or useexport_proxy_listto download your full credentials list in one go.
Real-World 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.
The Tradeoffs
Trying to read credentials without checking status
Calling list_proxies when you don't know if your account is nearing its bandwidth limit or has run out of replacement credits.
→
Always check the usage first. Run get_account_profile and then use get_bandwidth_stats. This prevents wasting resources on an already capped pool.
Manually updating whitelists
Having to log into the Webshare dashboard every time a developer spins up a new testing environment IP address.
→
Use the agent to run authorize_new_ip and automatically add the required IPs, keeping your workflow inside your chat client.
Assuming proxy credentials are static
Running a script that uses old or revoked IP addresses because you didn't check if they were removed from the authorized list.
→
First, run list_authorized_ips to get the current list, and then use revoke_ip_authorization when an endpoint is permanently decommissioned.
When It Fits, When It Doesn't
Use this MCP if your core requirement is managing credentials, rotation rules, and usage stats for a large proxy pool. It excels at lifecycle management: authorizing IPs (authorize_new_ip), tracking limits (get_account_profile), and maintaining the live list (list_proxies). Don't use this if you just need to read basic data—for instance, if all you need is one single IP address and its status. For that simple check, reading a small subset of list_proxies might suffice without calling the full MCP. However, if your process involves any change (add, delete, replace) or quota checking, this MCP's comprehensive tooling is required.
Common Questions About Webshare MCP
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.