Httpbin

liveDeveloperTechnology

httpbin — HTTP testing service: echo requests, return specific status codes, generate UUIDs, encode/decode Base64, and sample payloads.

16tools
0msauth
free tier50 calls/day

Tools

get

Send a GET request to httpbin.org and receive back the echoed request: query parameters (query object), custom headers, origin IP, and User-Agent. Use for HTTP debugging.

No parameters required.

▶Try it
post

Send a POST request to httpbin.org with optional body and custom headers; returns the echoed request including parsed JSON body, form data, and headers.

No parameters required.

▶Try it
headers

Echo caller's headers.

No parameters required.

▶Try it
ip

Caller IP (gateway egress).

No parameters required.

▶Try it
user_agent

Caller User-Agent.

No parameters required.

▶Try it
status

Return given HTTP status.

No parameters required.

▶Try it
delay

Sleep N seconds.

No parameters required.

▶Try it
uuid

Random UUID.

No parameters required.

▶Try it
base64_encode

Base64 encode.

No parameters required.

▶Try it
base64_decode

Base64 decode.

No parameters required.

▶Try it
json_anything

Fetch a sample JSON response from httpbin.org (/json). Use to verify JSON content-type handling or as a placeholder in tests.

No parameters required.

▶Try it
xml_anything

Fetch a sample XML response from httpbin.org (/xml). Use to verify XML content-type handling or as a placeholder in tests.

No parameters required.

▶Try it
html_anything

Fetch a sample HTML response from httpbin.org (/html). Use to verify HTML content-type handling or as a placeholder in tests.

No parameters required.

▶Try it
robots_txt

Fetch a sample robots.txt from httpbin.org (/robots.txt). Use to test robots.txt parsing or as a content-type placeholder.

No parameters required.

▶Try it
image

Sample image metadata (returns URL).

No parameters required.

▶Try it
cookies

Caller cookies.

No parameters required.

▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/httpbin/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/httpbin/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("get", {});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("httpbin — http testing service: echo requests, return specific status codes, generate uuids, encode/decode base64, and sample payloads");