# Httpstatus

> Httpstatus is a freemium MCP server for developer tools. Keyless HTTP status code lookup and class listing for developers and AI agents. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/httpstatus
- **Repository:** https://github.com/pipeworx-io/mcp-httpstatus
- **MCP Registry name:** io.github.pipeworx-io/httpstatus
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README describes this as a small reference server for HTTP status codes, served through the Pipeworx MCP gateway. It exposes a lookup tool that returns the reason phrase, category and meaning for any code in the 100-599 range, and a listing tool that can return all codes or filter them to a single class from 1xx to 5xx.

The lookup is described as keyless and offline, so an assistant can answer status code questions without a network round trip to a third party. Calls are routed through the Pipeworx gateway, which the README says counts calls against anonymous or free-account daily limits.

It suits developers writing API clients or debugging responses, and people building agents who want a quick, deterministic reference for status semantics. The endpoint also lists shared gateway meta-tools alongside the two pack tools, as the README notes.

## Features

- **Status code lookup:** Returns the reason phrase, category and meaning for a code from 100 to 599.
- **Class-based listing:** Lists codes overall or filtered to one class from 1xx through 5xx.
- **Keyless access:** The pack tools need no API key; an optional key only raises the daily call cap.
- **Multiple install paths:** Connects via remote streamable HTTP or a local npm stdio bridge.

## Good for

- Look up what a 422 or 503 response means while debugging an API
- List every 4xx code when designing error handling for a service
- Give an AI assistant a reliable reference for HTTP status semantics

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http httpstatus https://gateway.pipeworx.io/httpstatus/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/httpstatus/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "httpstatus": {
      "url": "https://gateway.pipeworx.io/httpstatus/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "httpstatus": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/httpstatus/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "httpstatus": {
      "serverUrl": "https://gateway.pipeworx.io/httpstatus/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "httpstatus": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/httpstatus/mcp"
    }
  }
}
```

## Tools

- `http_status`: Look up an HTTP status code (100-599): its reason phrase, category, and meaning. Keyless, offline.
- `list_http_statuses`: List HTTP status codes, optionally filtered to a class (1, 2, 3, 4 or 5 for 1xx…5xx).

## FAQ

### Does it need an API key?

The README says calls are anonymous without a key and capped daily; a free Pipeworx key raises the cap.

### Does the lookup work offline?

The pack is described as an offline reference, but the npm bridge README says it needs network access to reach the gateway.

### Which tools does it provide?

Two pack tools: http_status for a single code and list_http_statuses for listing by class.

### Is Httpstatus free?

Httpstatus has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Httpstatus to Claude Code?

Run this command in your terminal: claude mcp add --transport http httpstatus https://gateway.pipeworx.io/httpstatus/mcp

### What are the best alternatives to Httpstatus?

The closest alternatives to Httpstatus are Httpbin, HTTP status class 1xx-5xx, HTTP status class 1xx-5xx, Ipaddress and HTTP 102 processing.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Httpbin](https://ai-powered.com/mcp/httpbin): Httpbin is a freemium MCP server for developer tools.
- [HTTP status class 1xx-5xx](https://ai-powered.com/mcp/http-status-class-1xx-5xx): HTTP status class 1xx-5xx is an MCP server for developer tools.
- [HTTP status class 1xx-5xx](https://ai-powered.com/mcp/http-status-class-1xx-5xx-2): HTTP status class 1xx-5xx is an open-source MCP server for developer tools.
- [Ipaddress](https://ai-powered.com/mcp/ipaddress): Ipaddress is a freemium MCP server for developer tools.
- [HTTP 102 processing](https://ai-powered.com/mcp/http-102-processing): HTTP 102 processing is an MCP server for developer tools.
- [HTTP 302 found](https://ai-powered.com/mcp/http-302-found): HTTP 302 found is an MCP server for developer tools.
- [HTTP 101 switching-protocols](https://ai-powered.com/mcp/http-101-switching-protocols): HTTP 101 switching-protocols is an MCP server for developer tools.
- [Url](https://ai-powered.com/mcp/url): Url is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/httpstatus
