
Httpbin
Hosted MCP server wrapping httpbin.org for echoing requests, status codes and sample
- Pricing
- Freemium
- Platforms
- API, CLI, Web
- Runs
- Locally or Remotely
- Version
- 0.2.1
- Listing updated
- today
Similar MCP servers
About Httpbin
Httpbin is a freemium MCP server for developer tools. It can run locally on your machine or as a hosted remote server.
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.
Install
Run in a terminal
claude mcp add --transport http httpbin https://gateway.pipeworx.io/httpbin/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/httpbin/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"httpbin": {
"url": "https://gateway.pipeworx.io/httpbin/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"httpbin": {
"type": "http",
"url": "https://gateway.pipeworx.io/httpbin/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"httpbin": {
"serverUrl": "https://gateway.pipeworx.io/httpbin/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"httpbin": {
"type": "http",
"url": "https://gateway.pipeworx.io/httpbin/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.
Tools this server provides (16)
Taken from the project documentation; the running server may differ.
- 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.
What it does
- 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
Pricing
Freemium, from $49 a month
Anonymous 50 calls/day; free account 200 calls/day; paid credits beyond that
Prices change. Check pipeworx.io before you buy.
Httpbin 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.