MCP MeasureMCP Measure

index observed

ipvolt Proxy Toolkit

Proxy guides, tested configurations and error diagnostics, with an optional local route check.

Should I use this

Quality & Safety

A
Description quality
95%
Schema completeness
87%
Naming quality
95%
Poisoning risk
80%
Permission match
100%
Protocol compliance
100%

Findings (3)

  • HIGHTool poisoning patterns detected
  • MEDIUMTool 'generate_proxy_config' description contains placeholder textin generate_proxy_config
  • INFOTool description contains placeholder or incomplete textin generate_proxy_config

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,719Tokens (tool definitions)
~7.3 KBTypical response size
Significant attention impact (2.12% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "proxy-toolkit": {
      "command": "npx",
      "args": [
        "@ipvolt/proxy-toolkit-mcp"
      ]
    }
  }
}

Runnable packages

npm@ipvolt/proxy-toolkit-mcp0.1.0stdio

Remote endpoints

https://mcp.ipvolt.com/mcpstreamable-http

What it can do

Tool inventory

Tools (4)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢search_proxy_docs(query, topic, limit)

Find reviewed ipvolt public guides and articles. Returns canonical document IDs, excerpts and content revision. Submit a short topic query, never credentials or logs.

Input Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200
    },
    "topic": {
      "type": "string",
      "enum": [
        "setup",
        "troubleshooting",
        "concepts",
        "countries",
        "analysis"
      ]
    },
    "limit": {
      "default": 5,
      "type": "integer",
      "minimum": 1,
      "maximum": 5
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 160,
            "pattern": "^\\/(guides|blog)\\/[a-z0-9]+(?:-[a-z0-9]+)*$"
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "maxLength": 250
          },
          "description": {
            "type": "string",
            "maxLength": 1000
          },
          "reviewedAt": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
          },
          "topic": {
            "type": "string",
            "enum": [
              "setup",
              "troubleshooting",
              "concepts",
              "countries",
              "analysis"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "sha256": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "snippet": {
            "type": "string"
          },
          "score": {
            "type": "number"
          }
        },
        "required": [
          "id",
          "title",
          "description",
          "reviewedAt",
          "topic",
          "url",
          "sha256",
          "snippet",
          "score"
        ],
        "additionalProperties": false
      }
    },
    "provenance": {
      "type": "object",
      "properties": {
        "sourceRelease": {
          "type": "string"
        },
        "bundleSha256": {
          "type": "string",
          "pattern": "^[a-f0-9]{64}$"
        },
        "generatedAt": {
          "type": "string"
        }
      },
      "required": [
        "sourceRelease",
        "bundleSha256",
        "generatedAt"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "results",
    "provenance"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢get_proxy_doc(documentId, section, cursor)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "documentId": {
      "type": "string",
      "maxLength": 160,
      "pattern": "^\\/(guides|blog)\\/[a-z0-9]+(?:-[a-z0-9]+)*$"
    },
    "section": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160
    },
    "cursor": {
      "type": "string",
      "pattern": "^[a-f0-9]{16}:\\d{1,5}$"
    }
  },
  "required": [
    "documentId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "document": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "maxLength": 160,
          "pattern": "^\\/(guides|blog)\\/[a-z0-9]+(?:-[a-z0-9]+)*$"
        },
        "title": {
          "type": "string",
          "minLength": 1,
          "maxLength": 250
        },
        "description": {
          "type": "string",
          "maxLength": 1000
        },
        "reviewedAt": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        "topic": {
          "type": "string",
          "enum": [
            "setup",
            "troubleshooting",
            "concepts",
            "countries",
            "analysis"
          ]
        },
        "url": {
          "type": "string",
          "format": "uri"
        },
        "sha256": {
          "type": "string",
          "pattern": "^[a-f0-9]{64}$"
        }
      },
      "required": [
        "id",
        "title",
        "description",
        "reviewedAt",
        "topic",
        "url",
        "sha256"
      ],
      "additionalProperties": false
    },
    "markdown": {
      "type": "string"
    },
    "sections": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "chunk": {
      "type": "number"
    },
    "totalChunks": {
      "type": "number"
    },
    "nextCursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "provenance": {
      "type": "object",
      "properties": {
        "sourceRelease": {
          "type": "string"
        },
        "bundleSha256": {
          "type": "string",
          "pattern": "^[a-f0-9]{64}$"
        },
        "generatedAt": {
          "type": "string"
        }
      },
      "required": [
        "sourceRelease",
        "bundleSha256",
        "generatedAt"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "document",
    "markdown",
    "sections",
    "chunk",
    "totalChunks",
    "nextCursor",
    "provenance"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢generate_proxy_config(client, version, protocol, timeoutSeconds)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "client": {
      "type": "string",
      "enum": [
        "curl",
        "requests",
        "httpx",
        "playwright"
      ],
      "description": "Client whose exact tested configuration to generate."
    },
    "version": {
      "type": "string",
      "enum": [
        "8.22.0",
        "2.34.2",
        "0.28.1",
        "1.63.0"
      ],
      "description": "Exact tested version matching the client. Other versions are unsupported."
    },
    "protocol": {
      "default": "http",
      "description": "HTTP proxy with HTTPS CONNECT. Other proxy protocols are not tested.",
      "type": "string",
      "const": "http"
    },
    "timeoutSeconds": {
      "default": 15,
      "type": "integer",
      "minimum": 1,
      "maximum": 60
    }
  },
  "required": [
    "client",
    "version"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "client": {
      "type": "string",
      "enum": [
        "curl",
        "requests",
        "httpx",
        "playwright"
      ]
    },
    "version": {
      "type": "string",
      "enum": [
        "8.22.0",
        "2.34.2",
        "0.28.1",
        "1.63.0"
      ]
    },
    "protocol": {
      "type": "string",
      "const": "http"
    },
    "templateRevision": {
      "type": "string"
    },
    "language": {
      "type": "string",
      "enum": [
        "sh",
        "python",
        "javascript"
      ]
    },
    "interface": {
      "type": "string"
    },
    "testedRuntime": {
      "type": "string"
    },
    "code": {
      "type": "string",
      "maxLength": 16384
    },
    "environment": {
      "maxItems": 3,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "required": {
            "type": "boolean"
          },
          "secret": {
            "type": "boolean"
          },
          "description": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "required",
          "secret",
          "description"
        ],
        "additionalProperties": false
      }
    },
    "behavior": {
      "type": "object",
      "properties": {
        "method": {
          "type": "string",
          "const": "GET"
        },
        "followsRedirects": {
          "type": "boolean",
          "const": false
        },
        "automaticRetries": {
          "type": "number",
          "const": 0
        },
        "bypassesProxy": {
          "type": "boolean",
          "const": false
        },
        "verifiesTargetTls": {
          "type": "boolean",
          "const": true
        },
        "output": {
          "type": "string"
        },
        "timeoutSeconds": {
          "type": "integer",
          "minimum": 1,
          "maximum": 60
        },
        "timeoutScope": {
          "type": "string"
        }
      },
      "required": [
        "method",
        "followsRedirects",
        "automaticRetries",
        "bypassesProxy",
        "verifiesTargetTls",
        "output",
        "timeoutSeconds",
        "timeoutScope"
      ],
      "additionalProperties": false
    },
    "limitations": {
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "summary": {
      "type": "string"
    },
    "sources": {
      "maxItems": 3,
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      }
    }
  },
  "required": [
    "client",
    "version",
    "protocol",
    "templateRevision",
    "language",
    "interface",
    "testedRuntime",
    "code",
    "environment",
    "behavior",
    "limitations",
    "summary",
    "sources"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢diagnose_proxy_error(client, version, phase, status, exception, ...)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "client": {
      "type": "string",
      "enum": [
        "curl",
        "requests",
        "httpx",
        "playwright"
      ]
    },
    "version": {
      "type": "string",
      "enum": [
        "8.22.0",
        "2.34.2",
        "0.28.1",
        "1.63.0"
      ]
    },
    "phase": {
      "type": "string",
      "enum": [
        "configuration",
        "pool",
        "proxy_connect",
        "connect_tunnel",
        "target_tls",
        "request_send",
        "response_headers",
        "response_body",
        "unknown"
      ]
    },
    "status": {
      "description": "Observed HTTP status; identify its responding layer separately.",
      "type": "integer",
      "minimum": 100,
      "maximum": 599
    },
    "exception": {
      "description": "Normalized category, not raw exception text. HTTPX ConnectError alone does not establish a TLS error.",
      "type": "string",
      "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"
      ]
    },
    "responseSource": {
      "default": "unknown",
      "description": "Use target/proxy only when established by response provenance, not merely the status code.",
      "type": "string",
      "enum": [
        "proxy",
        "target",
        "unknown"
      ]
    },
    "method": {
      "default": "unknown",
      "type": "string",
      "enum": [
        "GET",
        "HEAD",
        "OPTIONS",
        "PUT",
        "DELETE",
        "POST",
        "PATCH",
        "unknown"
      ]
    },
    "requestMayHaveBeenSent": {
      "description": "Whether this target request may already have reached the application. Omit when unknown.",
      "type": "boolean"
    },
    "retryAfterSeconds": {
      "description": "Parsed bounded Retry-After delay, if actually observed. Never submit the raw header.",
      "type": "integer",
      "minimum": 0,
      "maximum": 86400
    }
  },
  "required": [
    "client",
    "version",
    "phase"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "client": {
      "type": "string",
      "enum": [
        "curl",
        "requests",
        "httpx",
        "playwright"
      ]
    },
    "version": {
      "type": "string",
      "enum": [
        "8.22.0",
        "2.34.2",
        "0.28.1",
        "1.63.0"
      ]
    },
    "rulesRevision": {
      "type": "string"
    },
    "evidence": {
      "type": "object",
      "properties": {
        "client": {
          "type": "string",
          "enum": [
            "curl",
            "requests",
            "httpx",
            "playwright"
          ]
        },
        "version": {
          "type": "string",
          "enum": [
            "8.22.0",
            "2.34.2",
            "0.28.1",
            "1.63.0"
          ]
        },
        "phase": {
          "type": "string",
          "enum": [
            "configuration",
            "pool",
            "proxy_connect",
            "connect_tunnel",
            "target_tls",
            "request_send",
            "response_headers",
            "response_body",
            "unknown"
          ]
        },
        "status": {
          "description": "Observed HTTP status; identify its responding layer separately.",
          "type": "integer",
          "minimum": 100,
          "maximum": 599
        },
        "exception": {
          "description": "Normalized category, not raw exception text. HTTPX ConnectError alone does not establish a TLS error.",
          "type": "string",
          "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"
          ]
        },
        "responseSource": {
          "default": "unknown",
          "description": "Use target/proxy only when established by response provenance, not merely the status code.",
          "type": "string",
          "enum": [
            "proxy",
            "target",
            "unknown"
          ]
        },
        "method": {
          "default": "unknown",
          "type": "string",
          "enum": [
            "GET",
            "HEAD",
            "OPTIONS",
            "PUT",
            "DELETE",
            "POST",
            "PATCH",
            "unknown"
          ]
        },
        "requestMayHaveBeenSent": {
          "description": "Whether this target request may already have reached the application. Omit when unknown.",
          "type": "boolean"
        },
        "retryAfterSeconds": {
          "description": "Parsed bounded Retry-After delay, if actually observed. Never submit the raw header.",
          "type": "integer",
          "minimum": 0,
          "maximum": 86400
        }
      },
      "required": [
        "client",
        "version",
        "phase",
        "responseSource",
        "method"
      ],
      "additionalProperties": false
    },
    "summary": {
      "type": "string"
    },
    "candidates": {
      "minItems": 1,
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "confidence": {
            "type": "string",
            "enum": [
              "supported",
              "possible"
            ]
          },
          "explanation": {
            "type": "string"
          },
          "nextCheck": {
            "type": "string"
          }
        },
        "required": [
          "code",
          "confidence",
          "explanation",
          "nextCheck"
        ],
        "additionalProperties": false
      }
    },
    "uncertainty": {
      "maxItems": 6,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "retry": {
      "type": "object",
      "properties": {
        "automaticRetryRecommended": {
          "type": "boolean",
          "const": false
        },
        "category": {
          "type": "string",
          "enum": [
            "reconcile_before_repeating",
            "bounded_retry_after_cause_check"
          ]
        },
        "advice": {
          "type": "string"
        }
      },
      "required": [
        "automaticRetryRecommended",
        "category",
        "advice"
      ],
      "additionalProperties": false
    },
    "sources": {
      "maxItems": 6,
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      }
    }
  },
  "required": [
    "client",
    "version",
    "rulesRevision",
    "evidence",
    "summary",
    "candidates",
    "uncertainty",
    "retry",
    "sources"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded4 tools
verifiedversion not recorded4 tools