Integrate the MiniWebtool HTTP Status Code Reference API into this project.

## Your task

1. Read the reference below.
2. Ask me where this belongs in the codebase if it is not obvious.
3. Write the integration in the language and style of the surrounding code:
   a small typed client function, errors handled, key read from the
   environment (never hard-coded, never committed).
4. Verify with `/dry-run` first, then exactly one live call.
5. Show me the diff and the live result.

## Credit budget — follow these exactly

This API is metered. A live call costs 1 credit; the free tier
includes 1,000 credits per month. Burning them during integration is the
single most common way to waste this key.

1. **Do all wiring against `/dry-run`, which costs 0 credits.** It validates the
   payload for real and returns a sample result with the exact response shape.
   Iterate there until your request builds and your parsing works.
2. **Make at most ONE live `/run` call** — a single end-to-end confirmation once
   dry-run passes. Print the result, then stop.
3. **Never call the API from unit tests, examples, or a retry loop.** Assert
   against the sample response captured from `/dry-run` instead.
4. **On 4xx, fix the payload — do not retry.** The error body is RFC 7807
   `application/problem+json` and says exactly what is wrong.
5. **On 429, honour `Retry-After`** and back off; do not tighten the loop.
6. **Read `X-MWT-Credits-Remaining`** on every response. If it drops below 50,
   stop making live calls and tell me.
7. If the integration needs repeated calls at runtime, **cache by input** — this
   tool is deterministic, so the same input always returns the same output.

## The API

**HTTP Status Code Reference** — Look up an HTTP status code or browse the registered codes by class with their defining RFCs.

- Live endpoint: `POST https://api.miniwebtool.com/v1/tools/http-status-code-reference/run` — costs 1 credit
- Dry run: `POST https://api.miniwebtool.com/v1/tools/http-status-code-reference/dry-run` — costs 0 credits, same auth and validation
- Auth: `Authorization: Bearer <MINIWEBTOOL_API_KEY>`
- Content type: `application/json`
- Tool version: `2026-04-22` (output shape is stable within a major version)
- Full machine-readable spec: `https://api.miniwebtool.com/v1/openapi.json`

### Request body

| field | type | required | notes |
|---|---|---|---|
| `code` | int | no | status code to look up, 0 to only browse (default `404`) |
| `category` | str | no | one of: all, 1xx, 2xx, 3xx, 4xx, 5xx — all \| 1xx \| 2xx \| 3xx \| 4xx \| 5xx (default `all`) |
| `search` | str | no | optional name substring filter |

Example request body:

```json
{
  "code": 404,
  "category": "all",
  "search": ""
}
```

### Response envelope

```json
{
  "request_id": "req_01H…",
  "tool": "http-status-code-reference",
  "tool_version": "2026-04-22",
  "credits_used": 1,
  "result": {
    "lookup": {
      "code": 404,
      "name": "Not Found",
      "reference": "RFC 9110 §15.5.5",
      "class": "4xx",
      "class_name": "Client Error",
      "class_description": "The request contains bad syntax or cannot be fulfilled."
    },
    "category": "all",
    "search": null,
    "match_count": 62,
    "codes": [
      {
        "code": 100,
        "name": "Continue",
        "reference": "RFC 9110 §15.2.1",
        "class": "1xx",
        "class_name": "Informational"
      },
      {
        "code": 101,
        "name": "Switching Protocols",
        "reference": "RFC 9110 §15.2.2",
        "class": "1xx",
        "class_name": "Informational"
      },
      {
        "code": 102,
        "name": "Processing",
        "reference": "RFC 2518 (WebDAV)",
        "class": "1xx",
        "class_name": "Informational"
      },
      {
        "code": 103,
        "name": "Early Hints",
        "reference": "RFC 8297",
        "class": "1xx",
        "class_name": "Informational"
      },
      {
        "code": 200,
        "name": "OK",
        "reference": "RFC 9110 §15.3.1",
        "class": "2xx",
        "class_name": "Success"
      },
      {
        "code": 201,
        "name": "Created",
        "reference": "RFC 9110 §15.3.2",
        "class": "2xx",
        "class_name": "Success"
      },
      {
        "code": 202,
        "name": "Accepted",
        "reference": "RFC 9110 §15.3.3",
        "class": "2xx",
        "class_name": "Success"
      },
      {
        "code": 203,
        "name": "Non-Authoritative Information",
        "reference": "RFC 9110 §15.3.4",
        "class": "2xx",
        "class_name": "Success"
      },
      {
        "code": 204,
        "name": "No Content",
        "reference": "RFC 9110 §15.3.5",
        "class": "2xx",
        "class_name": "Success"
      },
      {
        "code": 205,
        "name": "Reset Content",
        "reference": "RFC 9110 §15.3.6",
        "class": "2xx",
        "class_name": "Success"
      },
      {
        "code": 206,
        "name": "Partial Content",
        "reference": "RFC 9110 §15.3.7",
        "class": "2xx",
        "class_name": "Success"
      },
      {
        "code": 207,
        "name": "Multi-Status",
        "reference": "RFC 4918 (WebDAV)",
        "class": "2xx",
        "class_name": "Success"
      },
      {
        "code": 208,
        "name": "Already Reported",
        "reference": "RFC 5842 (WebDAV)",
        "class": "2xx",
        "class_name": "Success"
      },
      {
        "code": 226,
        "name": "IM Used",
        "reference": "RFC 3229",
        "class": "2xx",
        "class_name": "Success"
      },
      {
        "code": 300,
        "name": "Multiple Choices",
        "reference": "RFC 9110 §15.4.1",
        "class": "3xx",
        "class_name": "Redirection"
      },
      {
        "code": 301,
        "name": "Moved Permanently",
        "reference": "RFC 9110 §15.4.2",
        "class": "3xx",
        "class_name": "Redirection"
      },
      {
        "code": 302,
        "name": "Found",
        "reference": "RFC 9110 §15.4.3",
        "class": "3xx",
        "class_name": "Redirection"
      },
      {
        "code": 303,
        "name": "See Other",
        "reference": "RFC 9110 §15.4.4",
        "class": "3xx",
        "class_name": "Redirection"
      },
      {
        "code": 304,
        "name": "Not Modified",
        "reference": "RFC 9110 §15.4.5",
        "class": "3xx",
        "class_name": "Redirection"
      },
      {
        "code": 305,
        "name": "Use Proxy",
        "reference": "RFC 7231 (deprecated)",
        "class": "3xx",
        "class_name": "Redirection"
      },
      {
        "code": 307,
        "name": "Temporary Redirect",
        "reference": "RFC 9110 §15.4.8",
        "class": "3xx",
        "class_name": "Redirection"
      },
      {
        "code": 308,
        "name": "Permanent Redirect",
        "reference": "RFC 9110 §15.4.9",
        "class": "3xx",
        "class_name": "Redirection"
      },
      {
        "code": 400,
        "name": "Bad Request",
        "reference": "RFC 9110 §15.5.1",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 401,
        "name": "Unauthorized",
        "reference": "RFC 9110 §15.5.2",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 402,
        "name": "Payment Required",
        "reference": "RFC 9110 §15.5.3",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 403,
        "name": "Forbidden",
        "reference": "RFC 9110 §15.5.4",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 404,
        "name": "Not Found",
        "reference": "RFC 9110 §15.5.5",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 405,
        "name": "Method Not Allowed",
        "reference": "RFC 9110 §15.5.6",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 406,
        "name": "Not Acceptable",
        "reference": "RFC 9110 §15.5.7",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 407,
        "name": "Proxy Authentication Required",
        "reference": "RFC 9110 §15.5.8",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 408,
        "name": "Request Timeout",
        "reference": "RFC 9110 §15.5.9",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 409,
        "name": "Conflict",
        "reference": "RFC 9110 §15.5.10",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 410,
        "name": "Gone",
        "reference": "RFC 9110 §15.5.11",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 411,
        "name": "Length Required",
        "reference": "RFC 9110 §15.5.12",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 412,
        "name": "Precondition Failed",
        "reference": "RFC 9110 §15.5.13",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 413,
        "name": "Content Too Large",
        "reference": "RFC 9110 §15.5.14",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 414,
        "name": "URI Too Long",
        "reference": "RFC 9110 §15.5.15",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 415,
        "name": "Unsupported Media Type",
        "reference": "RFC 9110 §15.5.16",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 416,
        "name": "Range Not Satisfiable",
        "reference": "RFC 9110 §15.5.17",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 417,
        "name": "Expectation Failed",
        "reference": "RFC 9110 §15.5.18",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 418,
        "name": "I'm a teapot",
        "reference": "RFC 2324",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 421,
        "name": "Misdirected Request",
        "reference": "RFC 9110 §15.5.20",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 422,
        "name": "Unprocessable Content",
        "reference": "RFC 9110 §15.5.21",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 423,
        "name": "Locked",
        "reference": "RFC 4918 (WebDAV)",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 424,
        "name": "Failed Dependency",
        "reference": "RFC 4918 (WebDAV)",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 425,
        "name": "Too Early",
        "reference": "RFC 8470",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 426,
        "name": "Upgrade Required",
        "reference": "RFC 9110 §15.5.22",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 428,
        "name": "Precondition Required",
        "reference": "RFC 6585",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 429,
        "name": "Too Many Requests",
        "reference": "RFC 6585",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 431,
        "name": "Request Header Fields Too Large",
        "reference": "RFC 6585",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 451,
        "name": "Unavailable For Legal Reasons",
        "reference": "RFC 7725",
        "class": "4xx",
        "class_name": "Client Error"
      },
      {
        "code": 500,
        "name": "Internal Server Error",
        "reference": "RFC 9110 §15.6.1",
        "class": "5xx",
        "class_name": "Server Error"
      },
      {
        "code": 501,
        "name": "Not Implemented",
        "reference": "RFC 9110 §15.6.2",
        "class": "5xx",
        "class_name": "Server Error"
      },
      {
        "code": 502,
        "name": "Bad Gateway",
        "reference": "RFC 9110 §15.6.3",
        "class": "5xx",
        "class_name": "Server Error"
      },
      {
        "code": 503,
        "name": "Service Unavailable",
        "reference": "RFC 9110 §15.6.4",
        "class": "5xx",
        "class_name": "Server Error"
      },
      {
        "code": 504,
        "name": "Gateway Timeout",
        "reference": "RFC 9110 §15.6.5",
        "class": "5xx",
        "class_name": "Server Error"
      },
      {
        "code": 505,
        "name": "HTTP Version Not Supported",
        "reference": "RFC 9110 §15.6.6",
        "class": "5xx",
        "class_name": "Server Error"
      },
      {
        "code": 506,
        "name": "Variant Also Negotiates",
        "reference": "RFC 2295",
        "class": "5xx",
        "class_name": "Server Error"
      },
      {
        "code": 507,
        "name": "Insufficient Storage",
        "reference": "RFC 4918 (WebDAV)",
        "class": "5xx",
        "class_name": "Server Error"
      },
      {
        "code": 508,
        "name": "Loop Detected",
        "reference": "RFC 5842 (WebDAV)",
        "class": "5xx",
        "class_name": "Server Error"
      },
      {
        "code": 510,
        "name": "Not Extended",
        "reference": "RFC 2774",
        "class": "5xx",
        "class_name": "Server Error"
      },
      {
        "code": 511,
        "name": "Network Authentication Required",
        "reference": "RFC 6585",
        "class": "5xx",
        "class_name": "Server Error"
      }
    ],
    "classes": [
      {
        "class": "1xx",
        "name": "Informational",
        "description": "The request was received and the process is continuing."
      },
      {
        "class": "2xx",
        "name": "Success",
        "description": "The request was received, understood, and accepted."
      },
      {
        "class": "3xx",
        "name": "Redirection",
        "description": "Further action is needed to complete the request."
      },
      {
        "class": "4xx",
        "name": "Client Error",
        "description": "The request contains bad syntax or cannot be fulfilled."
      },
      {
        "class": "5xx",
        "name": "Server Error",
        "description": "The server failed to fulfil an apparently valid request."
      }
    ],
    "total_registered": 62
  }
}
```

`result` holds the tool output. Errors come back as
`application/problem+json` with `type`, `title`, `status`, and `detail`.

### Getting a key

If `MINIWEBTOOL_API_KEY` is not already in the environment, stop and ask me for
one — do not sign up, scrape, or guess a key. Free keys: https://api.miniwebtool.com/dashboard/