list_codes

Pack: httpcat · Endpoint: https://gateway.pipeworx.io/httpcat/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/list_codes for the schema, then POST the same URL with its arguments for the data.

Browse all available HTTP status codes with descriptions and cat image URLs. Use to find the right code for your status or explore available options.

Example call

Arguments

{}

curl

curl -X POST https://gateway.pipeworx.io/httpcat/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_codes","arguments":{}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('list_codes', {});

Response shape

Always returns: count, codes

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number",
      "description": "Total number of common HTTP status codes"
    },
    "codes": {
      "type": "array",
      "description": "List of common HTTP status codes with cat images",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "type": "number",
            "description": "HTTP status code"
          },
          "description": {
            "type": "string",
            "description": "Human-readable description of the code"
          },
          "image_url": {
            "type": "string",
            "description": "URL to the http.cat image for this code"
          }
        },
        "required": [
          "code",
          "description",
          "image_url"
        ]
      }
    }
  },
  "required": [
    "count",
    "codes"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "httpcat": {
      "url": "https://gateway.pipeworx.io/httpcat/mcp"
    }
  }
}

See Getting Started for client-specific install steps.