Cursor connects to a Nagent workspace with an API key. Once it is connected, agents can call 5 Cursor actions, such as "Get Agent Conversation", "Get API Key Info" and "List Agents". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Cursor, with input parameters and output schema.
CURSOR_GET_AGENT_CONVERSATIONTool to retrieve the conversation history for a specific cloud agent. Use when you need to view the messages exchanged between the user and the agent. Returns error with status 404 if the agent is not found or access is denied.
Input parameters
Unique identifier for the cloud agent. Must be a valid agent ID in UUID format with 'bc-' prefix (e.g., 'bc-550e8400-e29b-41d4-a716-446655440000'). Agent IDs can be obtained from the List Agents action.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CURSOR_GET_METool to retrieve API key information including the key name, creation date, and owner email. Use when you need to verify API key details or validate authentication.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CURSOR_LIST_AGENTSTool to retrieve a paginated list of all Cursor Cloud agents. Use when you need to view existing agents, their status, or iterate through agents with pagination.
Input parameters
Number of cloud agents to return. Must be between 1 and 100.
Pagination cursor from the previous response to fetch the next page of results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CURSOR_LIST_MODELSTool to retrieve the list of available AI models in Cursor. Use when you need to discover which models are available for API requests.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CURSOR_LIST_REPOSITORIESTool to list GitHub repositories accessible to the authenticated user. Use when you need to retrieve all repositories the user has access to through their Cursor account.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 5 Cursor actions on Nagent, including "Get Agent Conversation", "Get API Key Info" and "List Agents". Get Agent Conversation: Retrieve the conversation history for a specific cloud agent. Each action is listed on this page with its input parameters and its output.
Cursor connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Get Agent Conversation takes 1 required input: id. It returns data, error and successful.