ipvolt Proxy Toolkit is an MCP server published by io.github.ipvolt, hosted at mcp.ipvolt.com. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 4 tools, including search_proxy_docs, get_proxy_doc, generate_proxy_config, diagnose_proxy_error.
Rent and manage ipvolt mobile proxies locally with an API key, or try a no-key sandbox; proxy docs.
2 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Find reviewed ipvolt public guides and articles. Returns canonical document IDs, excerpts and content revision. Submit a short topic query, never credentials or logs.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| query * | string | |
| topic | string | one of ["setup","troubleshooting","concepts","countries","analysis"] |
{
"name": "search_proxy_docs",
"title": "Search reviewed proxy documentation",
"description": "Find reviewed ipvolt public guides and articles. Returns canonical document IDs, excerpts and content revision. Submit a short topic query, never credentials or logs.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 5,
"maximum": 5,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 2
},
"topic": {
"enum": [
"setup",
"troubleshooting",
"concepts",
"countries",
"analysis"
],
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"results",
"provenance"
],
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"description",
"reviewedAt",
"topic",
"url",
"sha256",
"snippet",
"score"
],
"properties": {
"id": {
"type": "string",
"pattern": "^\\/(guides|blog)\\/[a-z0-9]+(?:-[a-z0-9]+)*$",
"maxLength": 160
},
"url": {
"type": "string",
"format": "uri"
},
"score": {
"type": "number"
},
"title": {
"type": "string",
"maxLength": 250,
"minLength": 1
},
"topic": {
"enum": [
"setup",
"troubleshooting",
"concepts",
"countries",
"analysis"
],
"type": "string"
},
"sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"snippet": {
"type": "string"
},
"reviewedAt": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"description": {
"type": "string",
"maxLength": 1000
}
},
"additionalProperties": false
}
},
"provenance": {
"type": "object",
"required": [
"sourceRelease",
"bundleSha256",
"generatedAt"
],
"properties": {
"generatedAt": {
"type": "string"
},
"bundleSha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"sourceRelease": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Read a bounded chunk or named section using a document ID returned by search_proxy_docs. Follow nextCursor to continue; cursors are bound to the content revision.
| Parameter | Type | Description |
|---|---|---|
| cursor | string | |
| section | string | |
| documentId * | string |
{
"name": "get_proxy_doc",
"title": "Read a reviewed proxy document",
"description": "Read a bounded chunk or named section using a document ID returned by search_proxy_docs. Follow nextCursor to continue; cursors are bound to the content revision.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"documentId"
],
"properties": {
"cursor": {
"type": "string",
"pattern": "^[a-f0-9]{16}:\\d{1,5}$"
},
"section": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"documentId": {
"type": "string",
"pattern": "^\\/(guides|blog)\\/[a-z0-9]+(?:-[a-z0-9]+)*$",
"maxLength": 160
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"document",
"markdown",
"sections",
"chunk",
"totalChunks",
"nextCursor",
"provenance"
],
"properties": {
"chunk": {
"type": "number"
},
"document": {
"type": "object",
"required": [
"id",
"title",
"description",
"reviewedAt",
"topic",
"url",
"sha256"
],
"properties": {
"id": {
"type": "string",
"pattern": "^\\/(guides|blog)\\/[a-z0-9]+(?:-[a-z0-9]+)*$",
"maxLength": 160
},
"url": {
"type": "string",
"format": "uri"
},
"title": {
"type": "string",
"maxLength": 250,
"minLength": 1
},
"topic": {
"enum": [
"setup",
"troubleshooting",
"concepts",
"countries",
"analysis"
],
"type": "string"
},
"sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"reviewedAt": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"description": {
"type": "string",
"maxLength": 1000
}
},
"additionalProperties": false
},
"markdown": {
"type": "string"
},
"sections": {
"type": "array",
"items": {
"type": "string"
}
},
"nextCursor": {
"type": [
"string",
"null"
]
},
"provenance": {
"type": "object",
"required": [
"sourceRelease",
"bundleSha256",
"generatedAt"
],
"properties": {
"generatedAt": {
"type": "string"
},
"bundleSha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"sourceRelease": {
"type": "string"
}
},
"additionalProperties": false
},
"totalChunks": {
"type": "number"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Generate an HTTPS GET example for an exact tested curl, Requests, HTTPX or Playwright APIRequestContext version. Credentials and target are local environment placeholders. It does not execute the example or configure other agent tools.
| Parameter | Type | Description |
|---|---|---|
| client * | string | Client whose exact tested configuration to generate. |
| version * | string | Exact tested version matching the client. Other versions are unsupported. |
| protocol | string | HTTP proxy with HTTPS CONNECT. Other proxy protocols are not tested. |
| timeoutSeconds | integer |
{
"name": "generate_proxy_config",
"title": "Generate a tested proxy configuration",
"description": "Generate an HTTPS GET example for an exact tested curl, Requests, HTTPX or Playwright APIRequestContext version. Credentials and target are local environment placeholders. It does not execute the example or configure other agent tools.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client",
"version"
],
"properties": {
"client": {
"enum": [
"curl",
"requests",
"httpx",
"playwright"
],
"type": "string",
"description": "Client whose exact tested configuration to generate."
},
"version": {
"enum": [
"8.22.0",
"2.34.2",
"0.28.1",
"1.63.0"
],
"type": "string",
"description": "Exact tested version matching the client. Other versions are unsupported."
},
"protocol": {
"type": "string",
"const": "http",
"default": "http",
"description": "HTTP proxy with HTTPS CONNECT. Other proxy protocols are not tested."
},
"timeoutSeconds": {
"type": "integer",
"default": 15,
"maximum": 60,
"minimum": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client",
"version",
"protocol",
"templateRevision",
"language",
"interface",
"testedRuntime",
"code",
"environment",
"behavior",
"limitations",
"summary",
"sources"
],
"properties": {
"code": {
"type": "string",
"maxLength": 16384
},
"client": {
"enum": [
"curl",
"requests",
"httpx",
"playwright"
],
"type": "string"
},
"sources": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 3
},
"summary": {
"type": "string"
},
"version": {
"enum": [
"8.22.0",
"2.34.2",
"0.28.1",
"1.63.0"
],
"type": "string"
},
"behavior": {
"type": "object",
"required": [
"method",
"followsRedirects",
"automaticRetries",
"bypassesProxy",
"verifiesTargetTls",
"output",
"timeoutSeconds",
"timeoutScope"
],
"properties": {
"method": {
"type": "string",
"const": "GET"
},
"output": {
"type": "string"
},
"timeoutScope": {
"type": "string"
},
"bypassesProxy": {
"type": "boolean",
"const": false
},
"timeoutSeconds": {
"type": "integer",
"maximum": 60,
"minimum": 1
},
"automaticRetries": {
"type": "number",
"const": 0
},
"followsRedirects": {
"type": "boolean",
"const": false
},
"verifiesTargetTls": {
"type": "boolean",
"const": true
}
},
"additionalProperties": false
},
"language": {
"enum": [
"sh",
"python",
"javascript"
],
"type": "string"
},
"protocol": {
"type": "string",
"const": "http"
},
"interface": {
"type": "string"
},
"environment": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"required",
"secret",
"description"
],
"properties": {
"name": {
"type": "string"
},
"secret": {
"type": "boolean"
},
"required": {
"type": "boolean"
},
"description": {
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 3
},
"limitations": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 4
},
"testedRuntime": {
"type": "string"
},
"templateRevision": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use structured client/version, phase, status or exception observations to identify possible causes and the next check. Returns uncertainty and retry boundaries. Do not send raw logs, URLs or credentials.
| Parameter | Type | Description |
|---|---|---|
| phase * | string | one of ["configuration","pool","proxy_connect","connect_tunnel","target_tls","request_send","response_headers","response_body","unknown"] |
| client * | string | one of ["curl","requests","httpx","playwright"] |
| method | string | one of ["GET","HEAD","OPTIONS","PUT","DELETE","POST","PATCH","unknown"] |
| status | integer | Observed HTTP status; identify its responding layer separately. |
| version * | string | one of ["8.22.0","2.34.2","0.28.1","1.63.0"] |
| exception | string | Normalized category, not raw exception text. HTTPX ConnectError alone does not establish a TLS error. |
| responseSource | string | Use target/proxy only when established by response provenance, not merely the status code. |
| retryAfterSeconds | integer | Parsed bounded Retry-After delay, if actually observed. Never submit the raw header. |
| requestMayHaveBeenSent | boolean | Whether this target request may already have reached the application. Omit when unknown. |
{
"name": "diagnose_proxy_error",
"title": "Diagnose a proxy error",
"description": "Use structured client/version, phase, status or exception observations to identify possible causes and the next check. Returns uncertainty and retry boundaries. Do not send raw logs, URLs or credentials.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client",
"version",
"phase"
],
"properties": {
"phase": {
"enum": [
"configuration",
"pool",
"proxy_connect",
"connect_tunnel",
"target_tls",
"request_send",
"response_headers",
"response_body",
"unknown"
],
"type": "string"
},
"client": {
"enum": [
"curl",
"requests",
"httpx",
"playwright"
],
"type": "string"
},
"method": {
"enum": [
"GET",
"HEAD",
"OPTIONS",
"PUT",
"DELETE",
"POST",
"PATCH",
"unknown"
],
"type": "string",
"default": "unknown"
},
"status": {
"type": "integer",
"maximum": 599,
"minimum": 100,
"description": "Observed HTTP status; identify its responding layer separately."
},
"version": {
"enum": [
"8.22.0",
"2.34.2",
"0.28.1",
"1.63.0"
],
"type": "string"
},
"exception": {
"enum": [
"proxy_error",
"tls_error",
"connect_timeout",
"read_timeout",
"write_timeout",
"pool_timeout",
"connection_refused",
"dns_error",
"connection_reset",
"protocol_error",
"timeout",
"invalid_configuration",
"unknown"
],
"type": "string",
"description": "Normalized category, not raw exception text. HTTPX ConnectError alone does not establish a TLS error."
},
"responseSource": {
"enum": [
"proxy",
"target",
"unknown"
],
"type": "string",
"default": "unknown",
"description": "Use target/proxy only when established by response provenance, not merely the status code."
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0,
"description": "Parsed bounded Retry-After delay, if actually observed. Never submit the raw header."
},
"requestMayHaveBeenSent": {
"type": "boolean",
"description": "Whether this target request may already have reached the application. Omit when unknown."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client",
"version",
"rulesRevision",
"evidence",
"summary",
"candidates",
"uncertainty",
"retry",
"sources"
],
"properties": {
"retry": {
"type": "object",
"required": [
"automaticRetryRecommended",
"category",
"advice"
],
"properties": {
"advice": {
"type": "string"
},
"category": {
"enum": [
"reconcile_before_repeating",
"bounded_retry_after_cause_check"
],
"type": "string"
},
"automaticRetryRecommended": {
"type": "boolean",
"const": false
}
},
"additionalProperties": false
},
"client": {
"enum": [
"curl",
"requests",
"httpx",
"playwright"
],
"type": "string"
},
"sources": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 6
},
"summary": {
"type": "string"
},
"version": {
"enum": [
"8.22.0",
"2.34.2",
"0.28.1",
"1.63.0"
],
"type": "string"
},
"evidence": {
"type": "object",
"required": [
"client",
"version",
"phase",
"responseSource",
"method"
],
"properties": {
"phase": {
"enum": [
"configuration",
"pool",
"proxy_connect",
"connect_tunnel",
"target_tls",
"request_send",
"response_headers",
"response_body",
"unknown"
],
"type": "string"
},
"client": {
"enum": [
"curl",
"requests",
"httpx",
"playwright"
],
"type": "string"
},
"method": {
"enum": [
"GET",
"HEAD",
"OPTIONS",
"PUT",
"DELETE",
"POST",
"PATCH",
"unknown"
],
"type": "string",
"default": "unknown"
},
"status": {
"type": "integer",
"maximum": 599,
"minimum": 100,
"description": "Observed HTTP status; identify its responding layer separately."
},
"version": {
"enum": [
"8.22.0",
"2.34.2",
"0.28.1",
"1.63.0"
],
"type": "string"
},
"exception": {
"enum": [
"proxy_error",
"tls_error",
"connect_timeout",
"read_timeout",
"write_timeout",
"pool_timeout",
"connection_refused",
"dns_error",
"connection_reset",
"protocol_error",
"timeout",
"invalid_configuration",
"unknown"
],
"type": "string",
"description": "Normalized category, not raw exception text. HTTPX ConnectError alone does not establish a TLS error."
},
"responseSource": {
"enum": [
"proxy",
"target",
"unknown"
],
"type": "string",
"default": "unknown",
"description": "Use target/proxy only when established by response provenance, not merely the status code."
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0,
"description": "Parsed bounded Retry-After delay, if actually observed. Never submit the raw header."
},
"requestMayHaveBeenSent": {
"type": "boolean",
"description": "Whether this target request may already have reached the application. Omit when unknown."
}
},
"additionalProperties": false
},
"candidates": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"confidence",
"explanation",
"nextCheck"
],
"properties": {
"code": {
"type": "string"
},
"nextCheck": {
"type": "string"
},
"confidence": {
"enum": [
"supported",
"possible"
],
"type": "string"
},
"explanation": {
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 5,
"minItems": 1
},
"uncertainty": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 6
},
"rulesRevision": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Names, descriptions and schemas were written by the server and are shown as data.