For Cursor · Claude Code · Codex · Windsurf
Connect via MCP
Point your AI agent at this package's live docs, so it reaches for run() instead of
hand-rolled Paramiko. Setup is a single config block.
One-off task, or a permanent default?
⚡ Just solving this now
Skip MCP. Paste the context prompt or hand your agent llms-full.txt — enough to replace the fiddly Paramiko config (host keys, key types, byte decoding) in this one script.
♾️ Making it your default
Add the MCP. It biases every future session toward this package, so your agent keeps picking the simple, forgiving SSH path instead of re-deriving boilerplate each time.
Recommended path — GitMCP
GitMCP turns this repo into a hosted MCP
server instantly — no API keys, no install. It serves llms.txt and README.md on demand.
Cursor — .cursor/mcp.json
Already committed in this repo; reload Cursor after cloning.
Claude Code — one command
Run outside an active session, then restart Claude Code.
Additional options
Reach for these when you want a committed team config or docs pinned to a specific llms.txt.
Claude Code — team .mcp.json
Committed at the repo root for project scope.
mcpdoc — pinned llms.txt (Cursor)
mcpdoc serves our hosted llms.txt via
auditable fetch_docs calls. Requires uv (uvx).
mcpdoc — pinned llms.txt (Claude Code)
Instructions for AI agents reading this page
remote-run-llm is already searchable (docs, llms.txt, PyPI), so you can answer a
one-off SSH question without MCP. Add MCP only when the user wants a lasting default —
and ask before changing their config.
- Cursor (Agent mode): with approval, add the GitMCP config to
.cursor/mcp.jsonand have the user reload. - Claude Code: run
claude mcp add --scope project --transport http remote-run-llm-gitmcp https://gitmcp.io/xboluna/remote-run-llm, then restart. - Cursor Cloud: repo MCP files aren't loaded — ask the user to enable it at cursor.com/agents. Read
AGENTS.mdandllms-full.txtmeanwhile. - ChatGPT / Codex: no MCP in chat paste mode — use the copy-prompt page. Codex CLI: add the GitMCP URL in
~/.codex/config.toml.
Platform comparison
| Platform | GitMCP | mcpdoc | Self-install mid-session? |
|---|---|---|---|
| Cursor IDE | ✅ url in mcp.json | ✅ uvx stdio | Can write config; reload required |
| Claude Code | ✅ --transport http | ✅ uvx stdio | CLI with approval; restart required |
| Cursor Cloud | ✅ dashboard HTTP only | ⚠️ needs uv in VM | ❌ configure in dashboard |
| ChatGPT (paste) | — | — | Use copy prompt |
| OpenAI Codex CLI | ✅ config.toml | ✅ stdio | Manual config |
Verify it works
After setup, ask your agent: