{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_cba8b92see5a","handle":"cursor-cloud-mcp","url":"https://wellknown.network/agents/cursor-cloud-mcp","links":{"self":"https://wellknown.network/agents/cursor-cloud-mcp/record.json","html":"https://wellknown.network/agents/cursor-cloud-mcp","markdown":"https://wellknown.network/agents/cursor-cloud-mcp/record.md","api":"https://wellknown.network/api/v1/agents/cursor-cloud-mcp","status":"https://wellknown.network/api/v1/agents/cursor-cloud-mcp/status","claim":"https://wellknown.network/agents/cursor-cloud-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/cursor-cloud-mcp/claim.json","badge":"https://wellknown.network/agents/cursor-cloud-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/cursor-cloud-mcp/history","tools":"https://wellknown.network/api/v1/agents/cursor-cloud-mcp/tools"},"ard":{"identifier":"urn:air::server:cursor-cloud-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"cursor-cloud-mcp","summary":"MCP server for Cursor Cloud Agents (background agents): launch, follow up, supervise and cost Cursor agents from Claude Code, Codex CLI or OpenCode","description":"# cursor-cloud-mcp: MCP server for Cursor Cloud Agents\n\n[![PyPI](https://img.shields.io/pypi/v/cursor-cloud-mcp)](https://pypi.org/project/cursor-cloud-mcp/)\n[![Python](https://img.shields.io/pypi/pyversions/cursor-cloud-mcp)](https://pypi.org/project/cursor-cloud-mcp/)\n[![License: MIT](https://img.shields.io/pypi/l/cursor-cloud-mcp)](https://github.com/yoch/cursor-cloud-mcp/blob/main/LICENSE)\n\nDrive [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.\n\nTo 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.\n\n## Installation\n\nPython 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`:\n\n```bash\nuvx cursor-cloud-mcp\n```\n\nTo pin the version, or for a client with a short startup timeout, install it once and register the `cursor-cloud-mcp` command:\n\n```bash\nuv tool install cursor-cloud-mcp    # or: pipx install cursor-cloud-mcp\n```\n\nClient 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.\n\n## Variables\n\nThe server reads the process environment only, never a `.env` file. No tool changes these settings: edit the environment and restart the cli…","publisher":{"name":"Yoch Melka","url":null},"homepage":"https://github.com/yoch/cursor-cloud-mcp#readme","repository":"https://github.com/yoch/cursor-cloud-mcp#readme","version":"0.6.0","license":null,"protocols":["mcp"],"tags":["ai-agents","background-agents","claude-code","cloud-agents","codex","coding-agents","cursor","cursor-ai","cursor-cloud-agents","mcp","mcp-server","model-context-protocol","opencode"],"pricing":null,"endpoints":[{"url":"pypi:cursor-cloud-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.docs-lookup","name":"Documentation Lookup","confidence":0.791,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"},{"slug":"code.generation","name":"Code Generation","confidence":0.75,"provenance":"derived"}],"categories":["code","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"cursor-cloud-mcp","registry":"pypi","observedAt":"2026-10-21T20:26:15.530Z","publishedAt":"2026-10-19T19:23:59.927705Z","latestVersion":"0.6.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"cursor-cloud-mcp","url":"https://pypi.org/project/cursor-cloud-mcp/","firstSeenAt":"2026-10-09T17:24:24.362Z","fetchedAt":"2026-10-21T20:25:02.885Z","normalizedAt":"2026-10-21T20:25:02.885Z"}]},"firstSeenAt":"2026-10-09T17:24:24.362Z","updatedAt":"2026-10-21T20:26:15.530Z"}