# ipvolt Proxy Toolkit

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

- name: io.github.ipvolt/proxy-toolkit
- version: 0.1.1
- connection class: R0 (autonomous)
- trust: 94/100
- quality: 96/100 (strong)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.ipvolt%2Fproxy-toolkit
- tools: https://api.protogrid.dev/v1/servers/io.github.ipvolt%2Fproxy-toolkit/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "proxy-toolkit": {
      "type": "http",
      "url": "https://mcp.ipvolt.com/mcp"
    }
  }
}
```


## Trust

- hygiene: 100
- liveness: 100
- freshness: 85
- provenance: 90
- drivers: +repository +namespace-matches-repo +website +reachable +uptime-100% ~updated-35d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 96/100 (strong)

### protocol: 88 (weight 25)

- pass `protocol.modern`: supports 2026-07-28 (server/discover)
- pass `protocol.stateless`: answers without a session
- pass `protocol.transport`: streamable HTTP
- warn `protocol.list_ttl`: tools/list declares ttlMs 0, so clients re-fetch it on every use

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 4 of 4 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 1,049 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: no tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: 100 (weight 15)

- pass `deps.known_vulns`: no known advisory in 6 resolved packages
- pass `deps.mcp_sdk_version`: @modelcontextprotocol/node 2.0.0, no known advisory
- pass `deps.resolvable`: @ipvolt/proxy-toolkit-mcp@0.1.0 resolved: 6 packages

- tools: 4, about 1,049 tokens to load them all
- tool set hash: 9502c5c61819de4fbd46cb0c2dd81b0e
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.ipvolt/proxy-toolkit.svg)](https://protogrid.dev/servers/io.github.ipvolt/proxy-toolkit)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Dependencies

- npm @ipvolt/proxy-toolkit-mcp@0.1.0: resolved, 5 dependencies, MCP SDK @modelcontextprotocol/node 2.0.0

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0.

## Remotes

- https://mcp.ipvolt.com/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

- npm @ipvolt/proxy-toolkit-mcp@0.1.0 secrets: IPVOLT_PROXY_URL

## Tools (4)

- `diagnose_proxy_error`: 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.
- `generate_proxy_config`: 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.
- `get_proxy_doc`: 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.
- `search_proxy_docs`: Find reviewed ipvolt public guides and articles. Returns canonical document IDs, excerpts and content revision. Submit a short topic query, never credentials or logs.