MCP server for Cursor Cloud Agents (background agents): launch, follow up, supervise and cost Cursor agents from Claude Code, Codex CLI or OpenCode
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"cursor-cloud-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# cursor-cloud-mcp: MCP server for Cursor Cloud Agents [](https://pypi.org/project/cursor-cloud-mcp/) [](https://pypi.org/project/cursor-cloud-mcp/) [](https://github.com/yoch/cursor-cloud-mcp/blob/main/LICENSE) Drive [Cursor Cloud Agents](https://cursor.com/docs/cloud-agent) (formerly Background Agents) from any MCP client: Claude Code, Codex CLI or OpenCode. This local stdio MCP server exposes the Cursor Cloud Agents v1 REST API as nineteen tools: create a Cloud agent, choose its model, send follow-up runs, supervise a fleet of agents, read results, usage and cost, then archive or delete. It is not an orchestration platform. To have an agent install or use it, give it [`AGENT_GUIDE.md`](https://github.com/yoch/cursor-cloud-mcp/blob/main/AGENT_GUIDE.md): client setup, usage patterns, recovery and troubleshooting. Each tool's description, seen by every MCP client, is the reference for its parameters and fields. ## Installation Python 3.12 or newer. The package is on PyPI as `cursor-cloud-mcp`; the simplest is to let the MCP client start it with `uvx`: ```bash uvx cursor-cloud-mcp ``` To pin the version, or for a client with a short startup timeout, install it once and register the `cursor-cloud-mcp` command: ```bash uv tool install cursor-cloud-mcp # or: pipx install cursor-cloud-mcp ``` Client fragments for Claude Code, Codex and OpenCode are in [`examples/`](https://github.com/yoch/cursor-cloud-mcp/blob/main/examples). **Set the client's tool timeout to at least 100 seconds**: no call takes more than 95, but a client that gives up earlier may abandon a creation that was already sent, and pay for a second one on retry. ## Variables The server reads the process environment only, never a `.env` file. No tool changes these settings: edit the environment and restart the cli…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.