How to Use the Webshare MCP in Cursor

Q: How do I make Webshare proxy calls work with Cursor?

You add the server via .cursor/mcp.json or globally. Once configured, Agent mode lets the AI call tools like getaccountprofile and injects the live JSON response directly into your code editor context.

Q: Can I track Webshare usage metrics in Cursor?

Yes. The agent calls getbandwidthstats, pulling historical data that you can immediately use to calculate rate limits or optimize connection logic within the file you’re coding.

Q: How do I check Webshare access rights with Cursor?

You run listauthorizedips. The agent reads this list and lets you verify, right in your code editor's output pane, exactly which IPs are currently allowed without a password.

Inject live Webshare proxy data into your code using Cursor, right as you type.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Webshare MCP to Cursor

Create your Vinkius account to connect Webshare to Cursor and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Webshare with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Get Live Proxy Credentials

When writing networking code, use `list_proxies` to pull a paginated list of all active IPs. The live data includes ports and credentials, letting your agent inject them directly into the function you’re building. You can also call `get_proxy_configuration` to hardcode or reference Webshare's current rotation logic in your setup files.

Manage Proxy Replacements In Code

If a proxy fails during testing, the agent uses `request_proxy_replacement`. It calls this tool and then includes the resulting replacement IP immediately into the code block you're writing. The `get_replacement_quota` checks availability first. This prevents your code from running against an invalid assumption that you have replacements left.

Control Webshare Whitelisting via Code

Need to lock down access for a specific deployment? The agent uses `authorize_new_ip` to whitelist an IP, and later uses `revoke_ip_authorization` if the testing phase is over. It takes the required unique ID. Furthermore, you can use `list_authorized_ips` to verify that the correct IPs are currently whitelisted in your project's environment.

Setup guide

Set up Webshare MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Webshare MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Webshare transactions." If the MCP tools are loaded correctly, Cursor will call the Webshare tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "webshare-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Webshare now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Webshare MCP in Cursor

You add the server via `.cursor/mcp.json` or globally. Once configured, Agent mode lets the AI call tools like `get_account_profile` and injects the live JSON response directly into your code editor context.

Yes. The agent calls `get_bandwidth_stats`, pulling historical data that you can immediately use to calculate rate limits or optimize connection logic within the file you’re coding.

You run `list_authorized_ips`. The agent reads this list and lets you verify, right in your code editor's output pane, exactly which IPs are currently allowed without a password.

Yes. Since the tools provide live API responses, Cursor’s unique strength is that you get real context—not fake mock data—when writing code that relies on current proxy settings.

The server handles IP addresses and usage statistics, specifically recording bandwidth consumption. It provides access to credentials but only manages the infrastructure layer.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript