For the complete documentation index, see llms.txt.

HTTP Status Code Reference API

developer 1 credit / call v2026-04-22

Look up an HTTP status code or browse the registered codes by class with their defining RFCs.

One POST adds HTTP Status Code Reference to your app, site, workflow, or agent — formula, validation, edge cases, and docs already handled.

prefer a UI? Open the HTTP Status Code Reference on miniwebtool.com →

Start free — get a key → 1,000 credits · no card · 30 seconds

Endpoint

POST · 1cr
POST https://api.miniwebtool.com/v1/tools/http-status-code-reference/run

Request body

Field Type Req.
code
status code to look up, 0 to only browse
 int —
category
all | 1xx | 2xx | 3xx | 4xx | 5xx
 str —
search
optional name substring filter
 str —

Cost & access

  • 1 credit per successful call — failed calls refund.
  • Starts on: Free.
  • Max payload: 65536 bytes.
  • Privacy mode: hash_only
  • Available on: free, starter, pro, business, scale

Response envelope

{
  "request_id": "01K...",
  "tool": "http-status-code-reference",
  "tool_version": "2026-04-22",
  "credits_used": 1,
  "result": { ... }
}

Try it

Stored only in this browser tab. Playground test key is prefilled and only works on this page. Get a live key →
status code to look up, 0 to only browse
all | 1xx | 2xx | 3xx | 4xx | 5xx
optional name substring filter

Get your own key

1,000 free calls/mo · no card · key arrives by email

One verification click, then your key + a ready-to-run request. No card, no spam.

Code examples

curl -X POST https://api.miniwebtool.com/v1/tools/http-status-code-reference/run \
  -H 'Authorization: Bearer mwt_live_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"code":404,"category":"all","search":""}'
import requests

resp = requests.post(
    'https://api.miniwebtool.com/v1/tools/http-status-code-reference/run',
    headers={'Authorization': 'Bearer mwt_live_YOUR_KEY'},
    json={'code': 404, 'category': 'all', 'search': ''},
)
resp.raise_for_status()
data = resp.json()
print(data)
const resp = await fetch(
  'https://api.miniwebtool.com/v1/tools/http-status-code-reference/run',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer mwt_live_YOUR_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({"code":404,"category":"all","search":""}),
  }
);
const data = await resp.json();
console.log(data);
<?php
$ch = curl_init('https://api.miniwebtool.com/v1/tools/http-status-code-reference/run');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mwt_live_YOUR_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
    'code' => 404,
    'category' => 'all',
    'search' => ''
]),
]);
$resp = curl_exec($ch);
curl_close($ch);
print_r(json_decode($resp, true));
require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.miniwebtool.com/v1/tools/http-status-code-reference/run')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = (uri.scheme == 'https')

req = Net::HTTP::Post.new(uri)
req['Authorization'] = 'Bearer mwt_live_YOUR_KEY'
req['Content-Type'] = 'application/json'
req.body = {
  'code' => 404,
  'category' => 'all',
  'search' => ''
}.to_json

resp = http.request(req)
puts JSON.parse(resp.body).inspect
package main

import (
  "bytes"
  "encoding/json"
  "fmt"
  "io"
  "net/http"
)

func main() {
  body, _ := json.Marshal(map[string]interface{}{
    "code": 404,
    "category": "all",
    "search": "",
  })
  req, _ := http.NewRequest("POST", "https://api.miniwebtool.com/v1/tools/http-status-code-reference/run", bytes.NewReader(body))
  req.Header.Set("Authorization", "Bearer mwt_live_YOUR_KEY")
  req.Header.Set("Content-Type", "application/json")

  resp, err := http.DefaultClient.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  out, _ := io.ReadAll(resp.Body)
  fmt.Println(string(out))
}
import java.net.URI;
import java.net.http.*;

var client = HttpClient.newHttpClient();
var req = HttpRequest.newBuilder()
    .uri(URI.create("https://api.miniwebtool.com/v1/tools/http-status-code-reference/run"))
    .header("Authorization", "Bearer mwt_live_YOUR_KEY")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{\"code\":404,\"category\":\"all\",\"search\":\"\"}"))
    .build();

var resp = client.send(req, HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());
agents let your coding agent do it

Copy this into Claude Code, Cursor, Codex, Aider or Cline. It carries the endpoint, the full schema, a sample response, and the credit rules — so the agent wires http-status-code-reference up correctly without draining your key.

Free to iterate: the prompt points the agent at POST /v1/tools/http-status-code-reference/dry-run, which validates the request and returns the response shape for 0 credits. Only the final confirmation call is billed (1 credit).
Stable URL for this prompt: /tools/http-status-code-reference/prompt.md (?variant=cursor / ?variant=mcp).
Paste into Claude Code, or save as CLAUDE.md context.
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/
Paste into Codex, Aider, Cline, or any coding agent.
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/
Save as .cursor/rules/miniwebtool-http-status-code-reference.mdc
---
description: MiniWebtool HTTP Status Code Reference API — usage and credit budget
globs:
alwaysApply: false
---

# MiniWebtool HTTP Status Code Reference API

## 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/

## 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.
Skip the HTTP client — connect the agent directly.
Add the MiniWebtool MCP server to this project, then use the
`http-status-code-reference` tool from it.

Server URL: https://api.miniwebtool.com/v1/mcp
Transport: HTTP (Streamable HTTP / JSON-RPC 2.0)
Auth header: `Authorization: Bearer <MINIWEBTOOL_API_KEY>`

Claude Code:

```bash
claude mcp add --transport http miniwebtool https://api.miniwebtool.com/v1/mcp \
  --header "Authorization: Bearer $MINIWEBTOOL_API_KEY"
```

Or add it to the MCP config file your client uses:

```json
{
  "mcpServers": {
    "miniwebtool": {
      "type": "http",
      "url": "https://api.miniwebtool.com/v1/mcp",
      "headers": { "Authorization": "Bearer ${MINIWEBTOOL_API_KEY}" }
    }
  }
}
```

Once connected, `tools/list` exposes `http-status-code-reference` with its JSON Schema, so you can
call it directly instead of writing an HTTP client.

## 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.
how-to call http-status-code-reference
  1. Get an API key
    Get an API key. Sign up free for a bearer token. 1,000 credits/month, no card.
  2. Assemble the JSON body
    Required fields: . See the Request body table above for the full schema.
  3. POST to https://api.miniwebtool.com/v1/tools/http-status-code-reference/run
    Headers: Authorization: Bearer <key> and Content-Type: application/json. Copy-paste snippets in 7 languages are under Code examples.
  4. Parse the response
    Envelope: {request_id, tool, tool_version, credits_used, result}. The typed output lives in result.
faq frequently asked
What does the HTTP Status Code Reference API do?+

Look up an HTTP status code or browse the registered codes by class with their defining RFCs. Use it to add this utility without rebuilding formulas, validation, examples, and documentation.

How much does one call to HTTP Status Code Reference cost?+

1 credit per successful call. Failed calls (validation errors, 5xx) don't bill.

What parameters does the HTTP Status Code Reference API require?+

Required fields: (none). Full schema at /v1/openapi.json.

Is the HTTP Status Code Reference API deterministic?+

Yes — same input, same output, forever. Tool version 2026-04-22; output shape is stable within a major version.

Can an AI agent call the HTTP Status Code Reference API?+

Yes. Connect to https://api.miniwebtool.com/v1/mcp over the Model Context Protocol. The agent discovers `http-status-code-reference` with its JSON Schema automatically, so the model can plan while MiniWebtool handles the exact tool result.

What format does the API return?+

JSON with a stable envelope: `{request_id, tool, tool_version, credits_used, result}`. Errors are RFC 7807 `application/problem+json`.

mcp use from an AI agent

Every endpoint on this site is also exposed via the Model Context Protocol at https://api.miniwebtool.com/v1/mcp. Claude, Cursor, and any MCP-capable agent can discover this tool (http-status-code-reference) and its JSON Schema automatically — no client codegen. 

# List tools the agent can call
curl -s https://api.miniwebtool.com/v1/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
 | jq '.result.tools[] | select(.name=="http-status-code-reference")'
see-also related developer tools
JSON Formatter/Validator
Validate, beautify, minify, or repair JSON with precise error positions, size s…
JSON Schema Generator
Infer a JSON Schema (2020-12, 2019-09, or draft-07) from a sample document, wit…
UUID Validator/Decoder
Validate and decode UUIDs: version, variant, field breakdown, v1/v7 timestamps …
cURL Command Builder
Assemble a shell-safe curl command from method, URL, query parameters, headers,…