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