Skip to main content
Glama
http-prompt-reloaded

http-prompt-reloaded

🌐 HTTP Prompt Reloaded

PyPI version Python 3.10+ License: MIT Glama Score MCP Protocol Zero Dependencies Raptor Guard Certified WDAS Agent Ready

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:

  1. Navigate APIs like a File System: cd /api/v1/users, cd 42, cd ..

  2. Persistent Session Context: Headers (Bearer tokens, cookies) and query parameters persist across requests.

  3. 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).

  4. 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

http_prompt_init

Initialize or update a stateful session with a target base_url.

http_prompt_cd

Move through API endpoints hierarchically (cd /api/v1, cd ..).

http_prompt_configure

Set persistent headers (e.g. Authorization: Bearer ...) or query params.

http_prompt_execute

Execute an HTTP method (GET, POST, PUT, DELETE) with optional payload.


πŸ§ͺ 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 tools
http_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

    B3.3/5.0

    Scored across 4 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A 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.
      5
      1
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      -
    • A
      license
      A
      quality
      C
      maintenance
      A 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.
      42
      651 npm
      13
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Wraps bare-IP HTTP REST APIs as MCP tools, supporting dynamic IP switching and stdio/SSE modes for use in AI IDEs.
      -