RequestRepo MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
python -m pip install -e .
2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add requestrepo -- node "<FULL_PATH_TO_REQUESTREPO_MCP>/dist/index.js"

Replace <FULL_PATH_TO_REQUESTREPO_MCP>/dist/index.js with the actual folder you prepared in step 1.

README.md

An MCP server for managing HTTP requests, DNS configurations, files, and pings.

RequestRepo MCP

MCP server for `requestrepo` by `adragos`.

Scope

  • Full requestrepo tool surface (requests, sharing, DNS, files, ping)
  • Default stdio transport, optional streamable-http
  • Confirm-gated mutations (confirm=true)
  • JSON-safe bytes envelope for binary fields

Full parameter docs are in TOOLS.md.

Install

python -m pip install -e .

For local development:

python -m pip install -e ".[dev]"

Configuration

  • REQUESTREPO_TOKEN (optional)
  • REQUESTREPO_ADMIN_TOKEN (optional)
  • REQUESTREPO_HOST (default requestrepo.com)
  • REQUESTREPO_PORT (default 443)
  • REQUESTREPO_PROTOCOL (default https)
  • REQUESTREPO_VERIFY (default true)
  • REQUESTREPO_DEFAULT_TIMEOUT_SECONDS (default 30)
  • REQUESTREPO_MAX_BYTES (default 65536)

Auth behavior:

  • If REQUESTREPO_TOKEN is set, it is used.
  • Otherwise a new session is created, optionally with REQUESTREPO_ADMIN_TOKEN.

Run

requestrepo-mcp --transport stdio

requestrepo-mcp --transport streamable-http --host 127.0.0.1 --port 8000 --streamable-http-path /mcp

Install In AI Clients

Codex

With token (optional, recommended if you already have one):

codex mcp add requestrepo --env REQUESTREPO_TOKEN=your-token -- requestrepo-mcp --transport stdio

Without token (creates a new session automatically):

codex mcp add requestrepo -- requestrepo-mcp --transport stdio

Check config:

codex mcp get requestrepo

Autostart note:

  • Codex starts stdio servers automatically.
  • If startup fails, register with an absolute executable path:
codex mcp add requestrepo --env REQUESTREPO_TOKEN=your-token -- /absolute/path/to/requestrepo-mcp --transport stdio

Claude Code / Claude Desktop

{
  "mcpServers": {
    "requestrepo": {
      "command": "requestrepo-mcp",
      "args": ["--transport", "stdio"],
      "env": {
        "REQUESTREPO_TOKEN": "your-token"
      }
    }
  }
}

Cursor

{
  "mcpServers": {
    "requestrepo": {
      "command": "requestrepo-mcp",
      "args": ["--transport", "stdio"],
      "env": {
        "REQUESTREPO_TOKEN": "your-token"
      }
    }
  }
}

VS Code (Copilot Agent)

.vscode/mcp.json:

{
  "servers": {
    "requestrepo": {
      "type": "stdio",
      "command": "requestrepo-mcp",
      "args": ["--transport", "stdio"],
      "env": {
        "REQUESTREPO_TOKEN": "your-token"
      }
    }
  }
}

Tool Summary

  • session_info
  • list_requests
  • wait_for_request
  • delete_request
  • delete_all_requests
  • share_request
  • get_shared_request
  • list_dns
  • add_dns
  • remove_dns
  • update_dns
  • list_files
  • get_file
  • set_file
  • update_files
  • ping

Mutation tools require confirm=true.

Testing

pytest -q

CI runs tests on push and pull requests (see .github/workflows/ci.yml).

Tools (16)

session_infoRetrieve information about the current RequestRepo session.
list_requestsList all captured HTTP requests.
wait_for_requestWait for a specific request to be captured.
delete_requestDelete a specific captured request.
delete_all_requestsDelete all captured requests.
share_requestShare a captured request.
get_shared_requestRetrieve a previously shared request.
list_dnsList all configured DNS records.
add_dnsAdd a new DNS record.
remove_dnsRemove an existing DNS record.
update_dnsUpdate an existing DNS record.
list_filesList all files stored in the repository.
get_fileRetrieve a specific file.
set_fileUpload or set a file.
update_filesUpdate existing files.
pingPerform a ping operation.

Environment Variables

REQUESTREPO_TOKENAuthentication token for the session
REQUESTREPO_ADMIN_TOKENAdmin token for creating new sessions
REQUESTREPO_HOSTHost address for RequestRepo
REQUESTREPO_PORTPort for RequestRepo connection
REQUESTREPO_PROTOCOLProtocol to use (https/http)
REQUESTREPO_VERIFYWhether to verify SSL certificates
REQUESTREPO_DEFAULT_TIMEOUT_SECONDSDefault timeout for requests
REQUESTREPO_MAX_BYTESMaximum byte size for data

Configuration

claude_desktop_config.json
{"mcpServers": {"requestrepo": {"command": "requestrepo-mcp", "args": ["--transport", "stdio"], "env": {"REQUESTREPO_TOKEN": "your-token"}}}}

Try it

→List all the HTTP requests captured in my current RequestRepo session.
→Add a new DNS record for my test domain.
→Delete all existing requests to clear my dashboard.
→Retrieve the file named 'config.json' from my RequestRepo storage.
→Wait for a new incoming request and notify me when it arrives.

Frequently Asked Questions

What are the key features of RequestRepo MCP?

Full access to RequestRepo tool surface including requests, DNS, files, and pings. Supports both stdio and streamable-http transport protocols. Includes confirm-gated mutations for secure operations. Handles binary fields using a JSON-safe bytes envelope.

What can I use RequestRepo MCP for?

Debugging webhooks by capturing and inspecting incoming HTTP requests in real-time. Managing DNS records programmatically for testing network configurations. Storing and retrieving small configuration files or payloads during development. Monitoring network connectivity and response times using the ping tool.

How do I install RequestRepo MCP?

Install RequestRepo MCP by running: python -m pip install -e .

What MCP clients work with RequestRepo MCP?

RequestRepo MCP works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep RequestRepo MCP docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare
View all monitoring servers →

Related MCP Servers

Linux MCP Server
Read-only Linux system administration and diagnostics on RHEL-based systems.
monitoring189 stars
HomeButler
All-in-one homelab management MCP server.
monitoring64 stars
RenderDoc MCP
Analyze GPU frame captures for graphics debugging and performance analysis.
monitoring42 stars
EasyShell
AI-Native Server Operations Platform
monitoring37 stars
Reqable MCP Server
Exposes local Reqable network capture traffic to MCP clients
monitoring26 stars
VMware AIops
AI-powered VMware vCenter/ESXi monitoring and operations tool.
monitoring24 stars