# Httpbin

> Httpbin is a freemium MCP server for developer tools. Hosted MCP server wrapping httpbin.org for echoing requests, status codes and sample. 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, Web, self-hosted
- **Website:** https://pipeworx.io/packs/httpbin
- **Repository:** https://github.com/pipeworx-io/mcp-httpbin
- **MCP Registry name:** io.github.pipeworx-io/httpbin
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README describes this as an MCP wrapper around httpbin.org, a keyless service for inspecting HTTP requests and responses. It gives an AI client tools to echo GET and POST requests, return a chosen status code, add a delay, and fetch sample JSON, XML, HTML, robots.txt and image responses.

Beyond the upstream echo endpoints, the pack includes utilities that are handy in tests: generating a UUID and base64 encoding or decoding a string. The hosted endpoint runs at gateway.pipeworx.io and can also be reached through a small npm stdio bridge, which the README says forwards calls to the same gateway.

The endpoint also exposes shared Pipeworx meta-tools such as ask_pipeworx alongside this pack's own tools. Anonymous use is capped daily, and a free account raises the limit, according to the pricing page.

## Features

- **Request echo tools:** Returns GET and POST requests back with query, headers, body and caller IP or user agent.
- **Status code simulation:** Returns whatever HTTP status code is requested, useful for testing error handling.
- **Delay simulation:** Sleeps for a given number of seconds before responding, for timeout testing.
- **Sample payloads:** Provides sample JSON, XML, HTML, robots.txt and image responses for content-type checks.
- **Base64 and UUID helpers:** Encodes or decodes base64 strings and generates random UUIDs.
- **Multiple install routes:** Can be connected by remote URL, through mcp-remote, or via an npm stdio package.

## Good for

- Debugging how an HTTP client sends headers, query strings and bodies
- Checking that an app handles a specific status code such as 404 or 500
- Testing timeout behaviour by requesting a delayed response
- Verifying content-type handling with sample JSON, XML or HTML
- Generating test UUIDs or base64 strings inside an agent workflow

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `get`: Echo a GET request with query and headers.
- `post`: Echo a POST request with body, headers and content type.
- `headers`: Echo the caller's headers.
- `ip`: Return the caller's IP as seen by the gateway.
- `user_agent`: Return the caller's User-Agent.
- `status`: Return the given HTTP status code.
- `delay`: Sleep for N seconds then return.
- `uuid`: Return a random UUID.
- `base64_encode`: Base64-encode a string.
- `base64_decode`: Base64-decode a string.
- `json_anything`: Return a sample JSON response.
- `xml_anything`: Return a sample XML response.
- `html_anything`: Return a sample HTML response.
- `robots_txt`: Return a sample robots.txt.
- `image`: Return a sample image.
- `cookies`: Return the caller's cookies.

## FAQ

### Does it need an API key?

No. The README says it works keylessly, but anonymous calls are capped at 50 a day. A free Pipeworx account raises the cap to 200 a day.

### Which tools does this pack provide?

The README lists 16 tools, including get, post, headers, ip, user_agent, status, delay, uuid, base64_encode, base64_decode, json_anything, xml_anything, html_anything, robots_txt, image and cookies.

### Does the endpoint list only these tools?

No. The README says tools/list also returns shared Pipeworx meta-tools such as ask_pipeworx, and that the npm package lists only this pack's tools unless PIPEWORX_META_TOOLS=1 is set.

### Are calls billed?

The pricing page says a call that returns no data is not billed, and that signed-in accounts with credits continue past the free daily allowance at the listed rates.

### Is Httpbin free?

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

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

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

### What are the best alternatives to Httpbin?

The closest alternatives to Httpbin are Httpstatus, Url, Ipaddress, Dummyjson and Json.

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

- [Httpstatus](https://ai-powered.com/mcp/httpstatus): Httpstatus is a freemium MCP server for developer tools.
- [Url](https://ai-powered.com/mcp/url): Url is a freemium MCP server for developer tools.
- [Ipaddress](https://ai-powered.com/mcp/ipaddress): Ipaddress is a freemium MCP server for developer tools.
- [Dummyjson](https://ai-powered.com/mcp/dummyjson): Dummyjson is a freemium MCP server for developer tools.
- [Json](https://ai-powered.com/mcp/json): Json is a freemium MCP server for developer tools.
- [Unicode](https://ai-powered.com/mcp/unicode): Unicode is a freemium MCP server for developer tools.
- [Mime](https://ai-powered.com/mcp/mime): Mime is a freemium MCP server for developer tools.
- [Dns](https://ai-powered.com/mcp/dns-2): Dns is a freemium MCP server for developer tools.

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