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