http-prompt-reloaded
π HTTP Prompt Reloaded
Stateful Interactive API Navigation & Agentic MCP Engine.
The legendary 9.1k-star CLI REPL resurrected for modern Python (3.10β3.13) and upgraded into an autonomous AI Agent tool.
β‘ What is HTTP Prompt Reloaded?
Modern API exploration is broken: developers drown in bloated Electron apps (Postman/Insomnia) or struggle with massive, fragile cURL commands. The original httpie/http-prompt was brilliant, but broke down under ancient prompt_toolkit < 2.0 constraints.
HTTP Prompt Reloaded revives this concept as a zero-dependency, pure Python engine that bridges human developers and autonomous AI agents:
Navigate APIs like a File System:
cd /api/v1/users,cd 42,cd ..Persistent Session Context: Headers (Bearer tokens, cookies) and query parameters persist across requests.
Dual Operation:
Interactive CLI REPL for human terminal power users.
Native Model Context Protocol (MCP) JSON-RPC 2.0 Server for AI Agents (Claude Desktop, Cursor, Antigravity, Open-WebUI).
Hardened Security: Built-in SSRF protection (blocks cloud metadata endpoints like
169.254.169.254), CRLF header injection guards, and canonical URL traversal sanitization.
Related MCP server: req-mcp-server
π¦ Installation
# Via pip
pip install http-prompt-reloaded
# Or run instantly via uv / pipx
uvx http-prompt-reloaded http://localhost:8080π Human CLI Quickstart
# Start an interactive session on your API
http-prompt-reloaded https://api.github.com
# In the prompt:
/> cd /users/tastenkasperle
/users/tastenkasperle> header User-Agent MyDevAgent/1.0
/users/tastenkasperle> get
--> 200 https://api.github.com/users/tastenkasperle (112ms)
{
"login": "tastenkasperle",
...
}
/users/tastenkasperle> cd /repos
/repos> param sort updated
/repos> getπ€ MCP Integration for AI Agents
Give your AI coding assistants the power to test, explore, and debug live REST APIs with memory instead of spitting out static cURL strings!
Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"http-prompt": {
"command": "python",
"args": ["-m", "src.mcp.server"]
}
}
}Provided MCP Tools
Tool | Purpose |
| Initialize or update a stateful session with a target |
| Move through API endpoints hierarchically ( |
| Set persistent headers (e.g. |
| Execute an HTTP method ( |
π§ͺ Testing & Verification
Hermetic tests run in sub-second time without external network access using an ephemeral local test server:
python -m unittest discover testsπ‘οΈ License
MIT License. Based on the concept of httpie/http-prompt (9.1k Stars).
Available Tools
4 toolshttp_prompt_cdB
Navigates the API URL path like a directory (e.g., 'cd /api/v1', 'cd users', 'cd ..').
Inputs: path (required), session_id.
http_prompt_configureC
Sets persistent headers or query parameters for the session.
Inputs: params, headers, session_id.
http_prompt_executeC
Executes an HTTP request on the current stateful path.
Inputs: body, method, session_id.
http_prompt_initB
Initializes or updates a stateful HTTP exploration session.
Inputs: base_url (required), session_id.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 4 tools
Each tool maps to a distinct action in the session lifecycle: init (create session), cd (navigate path), configure (set headers/params), execute (send request). There is mild overlap between init's 'updates' behavior and configure's session-state mutation, but the descriptions keep them largely separable.
All four tools share the same http_prompt_ prefix followed by a clear verb (execute, init, cd, configure). The pattern is fully predictable and easy to scan.
Four tools is a lean but sensible set for a stateful HTTP exploration shell, with each tool earning its place. It is slightly thin, as a few more session-management operations could reasonably fit.
The surface covers the core lifecycle: session init, path navigation, configuration, and request execution. Minor gaps exist around resetting/clearing session state or removing individual headers, but core workflows are fully supported.
Maintenance
Related MCP Connectors
Host any HTTP API as MCP tools with a tamper-evident cross-agent settlement ledger.
Persistent memory, hybrid search and a goal graph for AI agents, over stdio or remote HTTP.
Host any HTTP API as a standard MCP server; auto-distribute to 12+ mainstream agent platforms.
Remote MCP server exposing your Node Command fleet (files, shell, processes, browser) to AI hosts.
Related MCP Servers
- AlicenseBqualityDmaintenanceA configurable MCP server that adapts any HTTP API into an MCP toolset with generic HTTP tools (GET, POST, PUT, DELETE) and pluggable authentication. Includes API discovery scripts and supports dynamic tool generation from OpenAPI specs or wordlist scans.51MIT
- FlicenseNot gradedqualityDmaintenanceA Bun-based MCP server providing a persistent HTTP request toolset for testing and inspecting JSON APIs. It supports session-aware operations, including cookie persistence, automatic bearer token reuse, and configurable base URLs.-
- AlicenseAqualityCmaintenanceA lightweight, local-first MCP server for executing HTTP requests and managing API collections and environments without cloud dependencies. It enables testing APIs, handling authentication, and importing OpenAPI specifications directly within MCP-compatible workflows.42651 npm13MIT
- FlicenseNot gradedqualityCmaintenanceWraps bare-IP HTTP REST APIs as MCP tools, supporting dynamic IP switching and stdio/SSE modes for use in AI IDEs.-