Connect Cursor to Your AI Agent

Choose an existing agent to request a follow-up plan or inspect the result of a run.

15 tools API key

Try a Cursor Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Cursor

Request a Follow-Up Plan

Add a planning task to an existing cloud agent.

/oo Cursor: For Cursor agent [agent ID], create a run in plan mode with instruction “[planning question]”. Check the returned run until it completes or fails and summarize its result.

Review Team Usage for a Period

Read usage records within a specified date range.

/oo Cursor: Read Cursor daily usage from [start date and timezone] to [end date and timezone]. Convert the dates to the required timestamps and summarize the returned team usage records.

Start Working with Cursor

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Cursor

    Connect a Cursor API key.

    Connect Cursor →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • Access to the cloud agent and team records you want to use.
  • Cloud agent tasks run asynchronously. Before a follow-up, the current run must finish or be cancelled; restore archived sessions first. Daily usage queries cover at most 30 days.

Cursor Tools

This connection manages Cursor cloud agents and runs and reads models, team members, audit logs, usage, and spend records.

Cloud Agents and Runs

Inspect agent sessions and create, follow, or cancel runs.

Team Usage and Audit Records

Read team context, usage, spend, and audit logs.

15 tools

Create Agent

Create a durable Cursor cloud session and enqueue its first run. Returns immediately; poll get_run for the result. MCP servers can give the session access to external tools.

cursor.create_agent

List Agents

List cloud sessions, newest first. Use nextCursor to request another page.

cursor.list_agents

Get Agent

Read a cloud session's configuration and latestRunId. Use get_run for execution status and results.

cursor.get_agent

Create Run

Send a follow-up using the session's conversation and workspace. Wait for or cancel an active run before starting another. Unarchive archived sessions first.

cursor.create_run

List Runs

List a cloud session's runs, newest first, with cursor pagination.

cursor.list_runs

Get Run

Read a run's progress, final assistant reply, and pushed branches. FINISHED, ERROR, CANCELLED, and EXPIRED are terminal statuses.

cursor.get_run

Cancel Run

Cancel an active run. To continue afterward, create a new run on the same session.

cursor.cancel_run

Archive Agent

Archive a session while retaining readable history. Call unarchive_agent before sending another prompt.

cursor.archive_agent

Unarchive Agent

Restore an archived session so it can accept new runs.

cursor.unarchive_agent

Delete Agent

Permanently delete a cloud session. This is irreversible; archive_agent provides reversible removal.

cursor.delete_agent

List Models

List available cloud agent models and their supported parameters and variants.

cursor.list_models

List Team Members

List Cursor team members visible to the team API key.

cursor.list_team_members

List Audit Logs

List Cursor team audit log events with optional time, event type, user, search, and page filters.

cursor.list_audit_logs

Get Daily Usage Data

Retrieve Cursor daily usage metrics for a team over a date range of up to 30 days.

cursor.get_daily_usage_data

Get Team Spend

Retrieve Cursor team spending for the current billing cycle with optional search, sort, and pagination.

cursor.get_team_spend

Frequently Asked Questions

Can I request a plan before implementation?

Yes. Agent and run requests accept plan mode for exploration and proposals, or agent mode for implementation.

Can I cancel a running task?

Use the agent ID and run ID to request cancellation of that run.

How do I choose a model?

Read the model list for available IDs and supported parameters, or omit model configuration to use the configured default.

Connect Cursor

About Cursor ↗