Built by Metorial, the integration platform for agentic AI.
Launch a new Cursor cloud agent to work on a GitHub repository. The agent receives a natural language prompt describing the task and operates on the specified repository. It can optionally create a pull request with its changes.
DEPRECATED — use `list_team_members` instead. Retrieve team members using the legacy numeric-ID contract. Current Cursor responses use encoded user IDs.
List available AI models that can be used when launching Cursor cloud agents.
Permanently delete a Cursor cloud agent. Conversation history will no longer be retrievable after deletion.
Send a new prompt to a durable cloud agent, reusing its conversation and workspace. Returns the new run ID for status checks.
Retrieve audit logs for your team. Logs include events like logins, logouts, settings changes, member management, API key activity, and policy violations. Requires an Admin API key.
List files produced by a Cursor cloud agent. Returns the file paths, sizes, and timestamps. Only agents created within the last six months are supported, and at most 100 artifacts are returned.
Get a temporary download URL for a specific agent artifact file. The returned presigned URL is valid for 15 minutes.
Retrieve the current status and details of a Cursor cloud agent by its ID. Returns the agent's status, source repository, target branch/PR information, and a summary of work done.
Delete a repository blocklist entry by its ID. After deletion, the repository's files will no longer be blocked from indexing. Requires an Admin API key.
List durable Cursor cloud agents, newest first, using the current public beta API. Returns agent identity, lifecycle state, URL, and latest run ID. Call get_cloud_agent for repositories and get_agent_run for execution state.
Set or remove a monthly spend limit for a team member. Set to null to remove the limit. Requires an Admin API key with Enterprise access.
Retrieve all repository blocklists configured for your team. Blocklists prevent files or directories matching specific patterns from being indexed or used as context. Requires an Admin API key.
Remove a member from the team. Requires an Admin API key with Enterprise access. Provide either the member's email or encoded user ID.
Stop a running Cursor cloud agent. The agent will cease its current work. A stopped agent can be resumed by sending a follow-up instruction.
DEPRECATED — use `get_team_spending` instead. Retrieve team spend using the legacy numeric-ID contract. Current Cursor responses use encoded user IDs and a different response envelope.
Prepare a downloadable file produced by a durable cloud agent. Use a relative path from list_cloud_agent_artifacts.
Get durable cloud agent metadata, repositories, branch settings, and latest run ID using the current public beta API. Use get_agent_run for completion state and final results.
Archive, unarchive, or permanently delete a durable cloud agent. Archive retains readable metadata but prevents new runs. Unarchive allows follow-up runs. Delete irreversibly removes the agent.
List a durable cloud agent’s runs, newest first, with pagination.
Retrieve detailed usage events for your team with filtering by date range, user, and pagination. Provides granular insights into individual API calls, model usage, token consumption, and costs. Requires an Admin API key.
Send a follow-up instruction to a running or stopped Cursor cloud agent. Use this to iterate on the agent's work, request modifications, or provide clarifications. Sending a follow-up to a stopped agent will resume it.
Retrieve the full conversation history of a Cursor cloud agent, including both user prompts and assistant responses. Not available for deleted agents.
Retrieve daily usage metrics for your team within a date range. Provides insights into code edits, AI assistance usage, tab completions, and acceptance rates per user per day. Requires an Admin API key.
Cancel an active cloud agent run. Cancellation is terminal for that run; create_agent_run starts a new prompt on the same conversation.
Get current-cycle Cursor team spending with encoded member IDs, on-demand and overall spending in cents, and effective user limits. Requires an Enterprise Admin API key with admin:* permissions.
List current and removed Cursor team members with their encoded user IDs, names, emails, and roles. Requires an Enterprise Admin API key with admin:* permissions. Use the IDs with remove_team_member; usage metrics use a separate numeric ID namespace, so filter usage by email.
Create a durable Cursor cloud agent and its initial run using the current public beta API. Supports connected GitHub, GitLab, Bitbucket Cloud, and Azure DevOps repositories, multiple repositories, and no-repository tasks.
List downloadable files produced by a durable cloud agent. Paths are relative to its workspace and can be passed directly to download_cloud_artifact.
List cloud agents in your Cursor account. Supports pagination and filtering by pull request URL.
Add or update repository blocklist patterns. If a blocklist for the repository URL already exists, its patterns will be updated. Use glob patterns to block files or directories from being indexed or used as context. Requires an Admin API key.
Retrieve information about the authenticated API key, including the associated user email and key metadata.
List GitHub repositories accessible to your Cursor account. These repositories can be used as sources when launching cloud agents.
Read run execution status, timestamps, duration, final reply, and pushed branches. Run statuses include CREATING, RUNNING, FINISHED, ERROR, CANCELLED, and EXPIRED. Git metadata is the agent’s current snapshot, shared across its runs.