# ipvolt Proxy Toolkit MCP server

> Provides reviewed proxy documentation, generates tested configuration templates, and diagnoses structured proxy connection failures.

- Repository: https://github.com/ipvolt/proxy-toolkit-mcp
- Page: https://hostedmcp.org/servers/ipvolt/proxy-toolkit-mcp
- Transport: stdio, remote
- Stars: 0
- License: MIT
- Latest version: 0.1.1

## Install

### Claude Code

```sh
claude mcp add --env 'IPVOLT_PROXY_URL=<YOUR_IPVOLT_PROXY_URL>' proxy-toolkit-mcp -- npx -y @ipvolt/proxy-toolkit-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "proxy-toolkit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ipvolt/proxy-toolkit-mcp"
      ],
      "env": {
        "IPVOLT_PROXY_URL": "<YOUR_IPVOLT_PROXY_URL>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "proxy-toolkit-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ipvolt/proxy-toolkit-mcp"
      ],
      "env": {
        "IPVOLT_PROXY_URL": "<YOUR_IPVOLT_PROXY_URL>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"proxy-toolkit-mcp","type":"stdio","command":"npx","args":["-y","@ipvolt/proxy-toolkit-mcp"],"env":{"IPVOLT_PROXY_URL":"<YOUR_IPVOLT_PROXY_URL>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "proxy-toolkit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ipvolt/proxy-toolkit-mcp"
      ],
      "env": {
        "IPVOLT_PROXY_URL": "<YOUR_IPVOLT_PROXY_URL>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add proxy-toolkit-mcp --env 'IPVOLT_PROXY_URL=<YOUR_IPVOLT_PROXY_URL>' -- npx -y @ipvolt/proxy-toolkit-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.proxy-toolkit-mcp]
command = "npx"
args = ["-y", "@ipvolt/proxy-toolkit-mcp"]

[mcp_servers.proxy-toolkit-mcp.env]
IPVOLT_PROXY_URL = "<YOUR_IPVOLT_PROXY_URL>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'IPVOLT_PROXY_URL=<YOUR_IPVOLT_PROXY_URL>' proxy-toolkit-mcp npx -- -y @ipvolt/proxy-toolkit-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "proxy-toolkit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ipvolt/proxy-toolkit-mcp"
      ],
      "env": {
        "IPVOLT_PROXY_URL": "<YOUR_IPVOLT_PROXY_URL>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `IPVOLT_PROXY_URL` | no | yes | Private HTTP proxy URL, required only when the local route diagnostic is enabled. Supply through the client's local secret environment; never as a tool argument. |
| `IPVOLT_ENABLE_ROUTE_CHECK` | no | no | Optional local route diagnostic. Set 1 only when you want the extra tool to make a bounded request through your configured proxy. |
| `IPVOLT_MCP_PUBLIC_URL` | no | no |  |

## Tools (5)

- `search_proxy_docs`
- `get_proxy_doc`
- `generate_proxy_config`
- `diagnose_proxy_error`
- `check_proxy_route`

## FAQ

### Do I need an API key to use the public tools?

No, the public tools run locally against a bundled catalog and do not require an API key or an ipvolt proxy account.

### Can this toolkit provision proxies or buy traffic?

No, the toolkit is separate from the commercial service and cannot provision proxies, buy traffic, or access account data.

### What does the diagnose_proxy_error tool do?

It interprets structured observations like TLS failures or timeouts to state uncertainty and retry boundaries.

### Is it safe to send credentials to the tools?

No, you should never send credentials, private URLs, or raw logs as tool arguments.