View as Markdown

Cursor Integration

Manage Cursor Cloud Agents and background tasks

The Cursor integration provides access to manage Cursor Cloud Agents and background tasks through the Integrate MCP server.

Installation

The Cursor integration is included with the SDK:

import { cursorIntegration } from "integrate-sdk/server";

Setup

Add Cursor to your server configuration:

import { createMCPServer, cursorIntegration } from "integrate-sdk/server";
 
export const { client: serverClient } = createMCPServer({
  apiKey: process.env.INTEGRATE_API_KEY,
  integrations: [
    cursorIntegration(),
  ],
});

Client-Side Usage

import { client } from "integrate-sdk";
 
const result = await client.cursor.listAgents({});
 
console.log(result);

Configuration Options

export interface CursorIntegrationConfig {
  /** Cursor API key (defaults to CURSOR_API_KEY env var) */
  apiKey?: string;

Tools

cursor_list_agents

List all cloud agents

export interface CursorListAgentsParams {
    /** Filter by status */
    status?: "running" | "completed" | "failed" | "stopped";

cursor_get_agent

Get agent status

export interface CursorGetAgentParams {
    /** Agent ID */
    agent_id: string;

cursor_get_conversation

Get conversation history

export interface CursorGetConversationParams {
    /** Conversation ID */
    conversation_id: string;

cursor_launch_agent

Launch a new agent

export interface CursorLaunchAgentParams {
    /** Task description */
    task: string;

cursor_followup_agent

Add follow-up instruction

export interface CursorFollowupAgentParams {
    /** Agent ID */
    agent_id: string;

cursor_stop_agent

Stop a running agent

export interface CursorStopAgentParams {
    /** Agent ID */
    agent_id: string;

cursor_delete_agent

Delete an agent

export interface CursorDeleteAgentParams {
    /** Agent ID */
    agent_id: string;

cursor_get_me

Get API key info

No parameters.

cursor_list_models

List available models

export interface CursorListModelsParams {
    /** Filter by provider */
    provider?: string;

cursor_list_repositories

List GitHub repositories

export interface CursorListRepositoriesParams {
    /** Maximum number of results */
    limit?: number;

Notes

  • Category: Engineering
  • Authentication mode: None