Free MCP server · Developer tools

Proxy setup. Inside your AI agent.

Generate proxy configurations, diagnose connection errors, and find the right guide. Bring the tools into your MCP-compatible coding agent.

  • Free to use
  • No account or API key
  • Open source
Connect the toolkitView on GitHub

Use the toolkit with your existing proxy provider. ipvolt proxy access is coming separately. Get early access

Configuration templates for

  • curl
  • Python Requests
  • HTTPX
  • Playwright

Four tools. One connection.

Less guessing. A clearer next step.

Four tools for the work between choosing a proxy and getting a request through.

Find the right guide

Search proxy setup and troubleshooting notes. Get relevant passages with links to the full source.

search_proxy_docs

Keep the source in reach

Read a section of a guide with its source and review information, so you can check the reasoning behind an answer.

get_proxy_doc

Start with a supported pattern

Generate configuration templates for curl, Requests, HTTPX or Playwright. Credentials stay in environment-variable placeholders.

generate_proxy_config

Find the next check

Describe the status, exception and request phase. Get likely causes and useful checks, with uncertainty made explicit.

diagnose_proxy_error

Templates cover curl shell commands, Python Requests sessions, synchronous HTTPX clients, and Playwright JavaScript API requests. Supported versions and tool details

Put it to work

Start with a real task.

Connect the server, then try a prompt. These are examples to use in your agent.

Describe the failure

Give your agent the client, version, exception or status, and the request phase. Leave out passwords, private URLs and full logs.

My HTTPX 0.28.1 request returns 407 during proxy connection. Help me identify the next check.
Example prompt

Compare a supported example

Ask for a configuration template and open its linked guide. The result identifies supported options and uses placeholders for secrets.

Show a synchronous HTTPX 0.28.1 proxy configuration using an environment variable, and explain which settings control routing.
Example prompt

Verify the route locally

If you enable the local tool, ask it to check the configured profile. This makes one bounded request; it does not test a site's content or change other tools.

Check the route for my configured local proxy profile, then explain what the result establishes.
Example prompt

Choose your connection

Hosted simplicity.
Local control.

ipvolt Proxy Toolkit is a Model Context Protocol (MCP) server for developers working with HTTP proxies. It gives your agent documentation, configuration templates and error diagnostics.

Recommended to start

Hosted, for a quick start.

Connect to the four core tools over HTTPS. No local process to install and no proxy credentials to share.

Core tools
All four
Connection
Streamable HTTP
Proxy route check
Not available
Proxy credentials
Not needed

Hosted tools do not connect to your proxy or request an arbitrary target URL.

Run on your machine

Local, for more control.

Run the same four tools through stdio. Enable the optional route check when you need to inspect one request from your own machine.

Core tools
All four
Connection
stdio · Node.js 24+
Proxy route check
Optional · explicitly enabled
Proxy credentials
Private local configuration for the route check

Keep proxy credentials in the documented local configuration, outside prompts and tool arguments. Enabling the package alone does not run a network check.

Use a client that supports Streamable HTTP. Its server settings and approval steps may differ; follow the instructions for your installed client.

Local package · v0.1.0Set up the local MCP server

Install Node.js 24 or later. Add the command and arguments below to your client's stdio MCP configuration. This example uses the common mcpServers format; use your client's equivalent if it differs. The version is pinned; update it deliberately when a reviewed release is available.

Local stdio server configuration
{
  "mcpServers": {
    "ipvolt-proxy-toolkit": {
      "command": "npx",
      "args": [
        "--yes",
        "@ipvolt/proxy-toolkit-mcp@0.1.0"
      ]
    }
  }
}
Optional · Local, opt-inCheck one request path
check_proxy_route

Make an explicitly requested local connection through a configured HTTP proxy to ipvolt's fixed HTTPS diagnostic endpoint. Returns the address observed for that request.

For the optional check, configure IPVOLT_PROXY_URL privately in the local server environment and set IPVOLT_ENABLE_ROUTE_CHECK=1. The tool accepts the profile name default, not a proxy URL or password. It supports HTTP proxies that tunnel HTTPS using CONNECT and contacts only https://mcp.ipvolt.com/egress.

Local route check setup details

What the result establishes

A route result applies to that request, process, endpoint and time. It does not prove that your browser or every tool in an agent session uses the same proxy.

An observed IP address does not establish country coverage, residential or mobile classification, anonymity, or access to a particular website.

The diagnostic tools suggest causes and next checks. A timeout after sending a write does not establish that retrying it is safe.

The toolkit does not provision ipvolt proxies, manage accounts, purchase traffic or submit a signup.

Privacy and analytics

Source, release notes and setup details Read as Markdown

Good to know

A few clear answers.

What is a proxy MCP server?

This MCP server gives an AI coding agent tools for HTTP proxy configuration and troubleshooting. MCP is the connection protocol between your client and the toolkit; your proxy provider supplies the actual proxy connection.

Is the toolkit free?

Yes. The hosted toolkit requires no account or API key, and the local package is open source. Traffic you send through your own proxy provider remains subject to that provider's terms and charges.

Which AI clients can connect?

Use an MCP client with Streamable HTTP support for the hosted endpoint, or stdio support for the local package. Configuration formats and tool approval flows vary by client; check your installed client's instructions.

Are the guides fetched live?

The toolkit searches a bundled snapshot of reviewed ipvolt guides. It does not crawl the web or automatically include every newly published guide. Open the source links in tool results to check the current page and its review information.

Does it route all of my agent's traffic through a proxy?

No. The toolkit generates configurations and diagnoses problems. The optional local route check makes one request through your configured HTTP proxy to a fixed HTTPS diagnostic endpoint. Other agent tools and browser traffic keep their own connection settings.

Do I need an ipvolt proxy to use it?

No. You can use the toolkit with an existing provider. ipvolt proxy access has a separate early-access list; joining it is optional and is not needed to connect the MCP server.

What should I keep out of prompts?

Keep passwords, proxy credentials, private URLs and full logs out of prompts and tool arguments. The configuration tools use placeholders. If you enable the local route check, provide credentials only through its documented local configuration.

Your next connection

Need the proxy, too?

Use the toolkit today with your own provider. Join ipvolt early access and we’ll email you when our proxy service opens.

Explore ipvolt

The first 500 signups get 5 GB free at launch.

No card, no expiry.

Keep building

Go deeper on your setup.

All developer guides

Scraper bandwidth report viewer

Open a scrapescope report to inspect hosts, resource types and browser background traffic.

Proxy environment variables

Understand configuration inheritance and routing overrides.

HTTPX async proxy setup

Use explicit clients and distinguish connection from pool timeouts.

Fix a 407 response

Separate authentication evidence from guesses about credentials.

Free tools

More free tools

All free tools

scrapescope

See where your scraper's proxy bandwidth goes.

Shows where your scraper's proxy bandwidth goes and finds the smallest response containing your data.

Free · open source · works with any provider

Open scrapescope