Cache Key Explosion Auditor

Audits a sample of HTTP request URLs against explicit, documented cache-key standardization rules (query param drops, query sorting, fragment dropping) and reports which distinct request variants would collapse onto the same proposed cache key. Never fetches or applies anything: it is a bounded, pure computation over the exact samples you provide. Equivalence between merged variants is only ever reported as "observed_equivalent" when every contributing sample carries the same explicit representation_id; otherwise the merge is flagged "conflict" (proven mismatch) or "unproven" (no evidence either way). No hit-rate, revenue, or cache-performance prediction is made, and no CDN/Cloudflare rule is ever read or written.

Pricing

0.05 per analysis

Requires x402 capable MCP client with wallet for payment settlement.

Input Schema

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "requests"
  ],
  "properties": {
    "requests": {
      "type": "array",
      "minItems": 1,
      "maxItems": 1000,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "maxLength": 2048
          },
          "method": {
            "type": "string",
            "enum": [
              "GET",
              "HEAD"
            ]
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "representation_id": {
            "type": "string",
            "maxLength": 256
          }
        }
      }
    },
    "rules": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "drop_query_params": {
          "type": "array",
          "maxItems": 100,
          "items": {
            "type": "string",
            "maxLength": 128
          }
        },
        "sort_query_params": {
          "type": "boolean"
        },
        "drop_fragment": {
          "type": "boolean"
        }
      }
    }
  }
}

Example Input

{
  "requests": [
    {
      "url": "https://shop.example.com/p/1?utm_source=x&id=1",
      "method": "GET",
      "count": 500,
      "representation_id": "r1"
    },
    {
      "url": "https://shop.example.com/p/1?id=1&utm_source=y",
      "method": "GET",
      "count": 300,
      "representation_id": "r1"
    },
    {
      "url": "https://shop.example.com/p/1?id=1&utm_source=z",
      "method": "GET",
      "count": 20,
      "representation_id": "r2"
    }
  ],
  "rules": {
    "drop_query_params": [
      "utm_source"
    ],
    "sort_query_params": true
  }
}

Example Output

{
  "ok": true,
  "summary": {
    "requests": 3,
    "sampled_hits": 820,
    "original_keys": 3,
    "proposed_keys": 1,
    "variants_removed": 2,
    "observed_conflict_groups": 1,
    "unproven_groups": 0
  },
  "groups": [
    {
      "proposed_key": "GET https://shop.example.com/p/1?id=1",
      "original_keys": [
        "GET https://shop.example.com/p/1?utm_source=x&id=1",
        "GET https://shop.example.com/p/1?id=1&utm_source=y",
        "GET https://shop.example.com/p/1?id=1&utm_source=z"
      ],
      "sample_indices": [
        0,
        1,
        2
      ],
      "sampled_hits": 820,
      "representation_ids": [
        "r1",
        "r2"
      ],
      "assessment": "conflict"
    }
  ],
  "rules": {
    "drop_query_params": [
      "utm_source"
    ],
    "sort_query_params": true,
    "drop_fragment": false
  },
  "scope": "supplied_samples_only"
}

Limitations

• Analyzes only the request samples supplied in this call; makes no claim about traffic not present in the sample (scope: supplied_samples_only).
• Does not fetch, crawl, or otherwise access the network; URLs are treated as opaque text.
• Does not predict cache hit-rate, revenue impact, or any performance outcome.
• Does not read, write, or apply any Cloudflare (or other CDN/vendor) cache rule.
• Default rules perform no query-parameter drops; marketing/tracking parameters are never assumed safe to drop unless explicitly named in drop_query_params.
• A merged group is only ever labeled observed_equivalent when every contributing request has a representation_id and all of them match; otherwise it is conflict or unproven.
• Bounded input only: <=1000 requests, URLs <=2048 chars, <=100 query parameter names per URL/rule list, each name <=128 chars, total request body <=128KiB.
• Only absolute http/https URLs without userinfo are accepted; malformed percent-encoding and other malformed input are rejected, never silently repaired.
• Results at most 96 KiB; retry identical input and authorization within 24 hours to recover a purchase.

Connect via MCP

Add to your MCP client configuration:

{
  "mcpServers": {
    "cache-key-explosion-auditor": {
      "type": "http",
      "url": "https://mcp-factory.bowling-anthony.workers.dev/cache-key-explosion-auditor/mcp"
    }
  }
}