Webshare MCP. Control your proxy pool and bandwidth stats via conversation.
Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Webshare MCP Server connects your AI client directly to a proxy network, letting you manage everything from IP whitelisting and quota checks to proxy replacement.
You can list residential and datacenter IPs, monitor bandwidth usage in real-time, and audit authorized access—all through conversation. No more logging into a dashboard just to cycle an IP or check your limits.
What your AI agents can do
Authorize new ip
Adds a new IP address to the authorized whitelist, allowing it to use your proxies without needing a password.
Export proxy list
Creates a temporary token that lets you download your entire list of proxy IPs in one single request.
Get account profile
Retrieves your Webshare user profile, including plan limits and current bandwidth quotas.
Get a full overview of your plan, bandwidth quota, and usage statistics using get_account_profile.
Retrieve the complete list of assigned IPs, including their ports, credentials, and current health status via list_proxies.
Grant proxy access to a specific server by running authorize_new_ip, adding it to the authorized IP list.
Review historical bandwidth and request statistics using get_bandwidth_stats to track consumption.
Request an immediate replacement for a specific IP that got blocked or flagged, provided you have quota remaining via request_proxy_replacement.
Ask AI about this MCP
Supported MCP Clients
Waiting for input…
Webshare MCP Server: 10 Tools for Proxy Management
Use these tools to programmatically control every aspect of your proxy pool—from whitelisting new IPs to monitoring usage stats.
019d7621authorize new ip
Adds a new IP address to the authorized whitelist, allowing it to use your proxies without needing a password.
019d7621export proxy list
Creates a temporary token that lets you download your entire list of proxy IPs in one single request.
019d7621get account profile
Retrieves your Webshare user profile, including plan limits and current bandwidth quotas.
019d7621get bandwidth stats
Gets historical data on your bandwidth usage and total request counts over time.
019d7621get proxy configuration
Retrieves the current settings for proxy rotation and backbone network details.
019d7621get replacement quota
Checks how many remaining slots you have to request a replacement for a blocked IP in this cycle.
019d7621list authorized ips
Lists every single IP address that is currently whitelisted and authorized to use your proxies.
019d7621list proxies
Shows all assigned proxy IPs, along with their ports, credentials, and active health status. Supports pagination.
019d7621request proxy replacement
Asks for an immediate swap of a specific IP address, provided your account has remaining replacement quota.
019d7621revoke ip authorization
Removes an IP address from the authorized whitelist permanently by requiring its unique ID.
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,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ 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
What you can do with this MCP connector
Webshare MCP Server connects your AI client right into your proxy network. This lets you manage everything from whitelisting IPs to checking quota limits—all through conversation. You don't gotta log into some dashboard just to cycle an IP or check if you're running out of bandwidth; your agent handles it all.
When you connect your AI client, you get full control over your proxy infrastructure. Here’s what you can do with the available tools:
Managing Your IPs and Access: You can see every single assigned IP address using list_proxies. That call gives you the ports, credentials, and current health status for all your proxies, even if it's paginated.
You need to audit who has access? Just run list_authorized_ips, which shows every IP currently whitelisted. If a server needs permission to use your proxies, you grant that access by running authorize_new_ip. That command adds the new IP to the whitelist without needing any passwords or manual intervention.
If an IP shouldn't have access anymore, you remove it permanently using revoke_ip_authorization, which takes a unique ID for sure. You can also export your whole list of proxy IPs at once by creating a temporary token with export_proxy_list—it’s a single request and gives you everything.
Handling Quota and Replacements: Running big data pulls means watching the numbers. First, check out your plan limits and bandwidth quotas using get_account_profile. This gives you the full overview you need before starting anything major. To track consumption over time, run get_bandwidth_stats to get historical usage and total request counts.
If an IP gets flagged or blocked mid-pull, don't sweat it; you can ask for a replacement immediately with request_proxy_replacement, but only if your account has remaining slots. Before hitting that button, check how many swaps you have left using get_replacement_quota.
Tuning Your Setup: You also gotta know what you're running against. Use get_proxy_configuration to pull the current settings for proxy rotation and backbone network details so you know if your crawlers are set up right.
Essentially, this server lets your agent act like a dedicated proxy administrator. You never have to switch screens or remember an API key just to check status. It’s all conversation. Your AI client manages the whole flow: getting stats with get_account_profile, listing every IP with list_proxies, authorizing new servers via authorize_new_ip, checking usage history with get_bandwidth_stats, requesting a swap when needed using request_proxy_replacement, and cleaning up access with revoke_ip_authorization or list_authorized_ips.
You keep the whole operation running from one chat window. It's pretty slick.
How Webshare MCP Works
- 1 Subscribe to the Webshare MCP Server and input your unique API Key into the client.
- 2 Your AI agent accesses the toolset, allowing you to issue commands like 'List all proxies' or 'Check my quota'.
- 3 The server executes the function call against your account and returns a plain text result (e.g., IP list, usage stats) that the agent summarizes for you.
The bottom line is: it makes your AI client act like an API wrapper for proxy management, eliminating manual dashboard interaction.
Who Is Webshare MCP For?
This is for the data engineer who gets annoyed by context switching. If you spend more time clicking through dashboards (checking quotas, whitelisting IPs) than actually writing scraping code, this server saves your afternoon. It's built for people whose job requires large-scale, reliable access to proxy networks.
Automating the setup and maintenance of web scraping pipelines by programmatically managing IP whitelists using authorize_new_ip.
Monitoring infrastructure health, checking bandwidth usage via get_bandwidth_stats, and adjusting proxy configurations through chat commands.
Quickly retrieving large lists of geo-targeted proxies or updating IP access rights for specific data collection campaigns.
What Changes When You Connect
- Quota Visibility: Use
get_account_profileto check your plan limits before running any large scrape. You stop wasting time waiting for quota errors when you know your remaining allowance right away. - Instant IP Control: Need to grant access to a new machine? Run
authorize_new_ip. It whitelists the IP instantly, letting it use proxies without manual password entry or dashboard clicks. - High-Volume Data Pulls: Don't manually copy hundreds of IPs. Use
export_proxy_listto generate one temporary token and download your entire proxy pool list in a single command. - Active Problem Solving: If an IP gets flagged, don't wait for support. Run
request_proxy_replacementimmediately (if quota allows) and get a fresh endpoint without leaving your chat window. - Full Audit Trail: Quickly see who has access by running
list_authorized_ips. This ensures only approved servers can connect to your proxy pool, improving security.
Real-World Use Cases
The Scraping Pipeline Needs a New IP Range
A data engineer needs their scrapers to hit new domains. They ask their agent: 'List all proxies and check the quota first.' The agent runs list_proxies for current IPs, then uses get_account_profile to confirm bandwidth. Finally, it identifies a block of unused IPs ready for use.
A Security Audit Requires IP Removal
The security team detects compromised credentials on an old machine. They ask the agent to remove access immediately. The agent uses revoke_ip_authorization with the specific ID, instantly cutting off unauthorized access without needing admin logins.
Bandwidth Usage Mystery
A market researcher wonders why their bandwidth is dropping faster than expected. They ask: 'What are my stats for this month?' The agent runs get_bandwidth_stats, showing a clear usage spike correlating with a recent campaign, allowing the researcher to adjust future limits.
Setting up a New Internal Tool
A DevOps professional spins up a new internal monitoring server. Instead of manually logging into Webshare, they ask their agent to 'Authorize 192.168.5.10.' The agent runs authorize_new_ip, making the IP usable immediately for testing.
The Tradeoffs
Assuming Unlimited Quota
Running a massive scrape job because you think you have enough bandwidth, only to get hit with quota errors halfway through and losing hours of work.
→
Always check your limits first. Before initiating a big task, run get_account_profile or get_replacement_quota. This prevents costly failures.
Manual IP Whitelisting
Having to manually navigate the Webshare dashboard every time a new service needs access, wasting 5-10 minutes per server.
→
Use authorize_new_ip with your agent. It handles the whitelisting in one step, letting you keep working without context switching.
Ignoring IP Credentials
Using a proxy list that hasn't been updated since last week, resulting in blocked IPs and failed requests because credentials expired.
→
Always call list_proxies first. This provides the current health status and necessary credentials for your entire pool.
When It Fits, When It Doesn't
Use this server if you need to treat proxy management like an API layer. You're automating operational tasks: checking quotas, whitelisting IPs, or swapping endpoints. If your workflow requires continuous, programmatic control over the physical state of your proxies (like needing list_proxies details for a script), this is what you use. Don't use it if all you need is a simple visual graph of usage—the stats are text-based. Also, remember that while tools like get_proxy_configuration help understand the network backbone, they don't solve policy problems; they just show the current settings.
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.
Available Capabilities
Managing proxies shouldn't involve jumping between five different web dashboards.
Today, if your team needs to update a single IP or check the bandwidth limit for a run, you have to copy and paste credentials, log into the main dashboard, find the correct tab (whitelisting, quota, IPs), manually submit the request, and wait for confirmation. It's slow, tedious, and prone to human error.
With this MCP server, you just tell your agent what needs doing: 'Authorize 192.168.5.10.' The AI runs `authorize_new_ip` immediately and tells you it worked. You get back a simple confirmation message—no dashboard clicks required.
Webshare MCP Server: Full Proxy Control in Conversation
Manual IP management forces you to stop coding, open a browser, and learn the specific UI flow for every single action. Checking quotas means one tab; listing IPs means another; whitelisting requires a third login.
Now, your agent handles the whole stack. You ask it to check both the quota *and* list all proxies in one go. It runs `get_account_profile` and `list_proxies`, then summarizes everything for you. That's how fast it is.
Common Questions About Webshare MCP
How do I check my current proxy limits using the Webshare MCP Server? +
Run get_account_profile. This tool reads your plan details and bandwidth quota, telling you exactly how much usage you have remaining before starting any large data task.
Can I add a new IP address to my proxy pool using the Webshare MCP Server? +
Yes. Use authorize_new_ip. It whitelists an IP for proxy access instantly, letting it connect without needing password authentication.
What if one of my proxies gets blocked? Can I use the Webshare MCP Server to fix it? +
You can run request_proxy_replacement. This asks for an immediate swap of a specific IP, provided your account still has replacement quota available.
What is the difference between list_proxies and list_authorized_ips? +
Use list_proxies to see all active IPs with their credentials and health status. Use list_authorized_ips to only see which IPs are whitelisted for access.
How do I use `export_proxy_list` to get all my proxy IPs? +
It generates a temporary token that lets you download your entire proxy list in one go. Use this when you need the full pool for bulk processing or archival, avoiding manual listing requests.
What if I need to stop an IP from accessing my proxies? How does `revoke_ip_authorization` work? +
You must provide the unique ip_id. This tool immediately removes the address from your authorized whitelist, guaranteeing that specific machine loses all proxy access.
I'm troubleshooting a crawler failure. What information does `get_proxy_configuration` give me? +
This function retrieves your current proxy rotation and backbone network settings. It helps you diagnose if your crawlers are configured with the correct operational parameters.
I need historical usage data, not just my current quota. How do I use `get_bandwidth_stats`? +
It pulls detailed records of bandwidth consumption and request success/failure rates over time. This lets you analyze performance trends when debugging large-scale scraping jobs.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Webflow Alternative
Manage Webflow sites, CMS collections, pages, and assets directly from your AI agent.
Clarifai (Vision AI)
Manage AI inference via Clarifai — list apps, models, and workflows, and perform computer vision predictions directly from any AI agent.
TAPD
Agile product development and collaboration platform by Tencent — manage stories, bugs, and iterations via AI.
You might also like
BigCommerce
Manage your online store with product catalogs, order fulfillment, and customer data for high-volume e-commerce operations.
Corpay One
Simplify business payments with automated AP processing, virtual cards, and vendor management that saves your finance team hours.
Yida
Enterprise low-code development platform by DingTalk — manage forms, data instances, and approval workflows via AI.