CursorAgentsApi
Description: Tools that enable LLMs to interact directly with the cursor_agents API.
Author: Arcade
Auth: API Key
CursorAgentsApi is a Starter MCP Server: each tool mirrors one HTTP endpoint and offers LLMs a way to interact with the low-level API.
Differently from Optimized MCP Servers, Starter tools are heavily influenced by the original API design, which is not usually optimized for LLM usage. For this reason, we recommend thoroughly evaluating the tools with your Agents or chatbots before using it in production. Read more about Optimized vs Starter tools.
The CursorAgentsApi MCP Server provides tools for managing and inspecting background agents, authentication info, model recommendations, and linked GitHub repos. These tools let users and LLMs:
- List, inspect, and delete background agents.
- Retrieve an agent’s current status, results, and full conversation history.
- Verify API key / user info used for authentication.
- Fetch recommended models for background agents.
- List GitHub repositories accessible to the authenticated user.
Available Tools
| Tool Name | Description |
|---|---|
| CursorAgentsApi.ListBackgroundAgents | List all background agents for the user. |
| CursorAgentsApi.GetAgentStatus | Retrieve the current status and results of a background agent. |
| CursorAgentsApi.DeleteBackgroundAgent | Permanently delete a background agent. |
| CursorAgentsApi.GetAgentConversationHistory | Retrieve the conversation history of a background agent. |
| CursorAgentsApi.RetrieveApiUserInfo | Retrieve information about the API key used for authentication. |
| CursorAgentsApi.ListRecommendedModels | Retrieve recommended models for background agents. |
| CursorAgentsApi.ListGithubRepositories | Retrieve accessible GitHub repositories for a user. |
If you need to perform an action that’s not listed here, you can get in touch with us to request a new tool, or create your own tools.
CursorAgentsApi.ListBackgroundAgents
List all background agents for the user.
Parameters
- agent_limit (
integer, optional) Number of background agents to return for the request. - pagination_cursor (
string, optional) Pagination cursor from the previous response to navigate pages.
Secrets
This tool requires the following secrets: CURSOR_AGENTS_API_KEY (learn how to configure secrets)
CursorAgentsApi.GetAgentStatus
Retrieve the current status and results of a background agent.
Parameters
- background_agent_id (
string, required) A unique identifier required to retrieve the status and results of the specified background agent.
Secrets
This tool requires the following secrets: CURSOR_AGENTS_API_KEY (learn how to configure secrets)
CursorAgentsApi.DeleteBackgroundAgent
Permanently delete a background agent.
Parameters
- background_agent_id (
string, required) Unique identifier for the background agent to be deleted permanently.
Secrets
This tool requires the following secrets: CURSOR_AGENTS_API_KEY (learn how to configure secrets)
CursorAgentsApi.GetAgentConversationHistory
Retrieve the conversation history of a background agent.
Parameters
- background_agent_id (
string, required) Unique identifier for the background agent to retrieve conversation history.
Secrets
This tool requires the following secrets: CURSOR_AGENTS_API_KEY (learn how to configure secrets)
CursorAgentsApi.RetrieveApiUserInfo
Retrieve information about the API key used for authentication.
Parameters
This tool does not take any parameters. Secrets
This tool requires the following secrets: CURSOR_AGENTS_API_KEY (learn how to configure secrets)
CursorAgentsApi.ListRecommendedModels
Retrieve recommended models for background agents.
Parameters
This tool does not take any parameters. Secrets
This tool requires the following secrets: CURSOR_AGENTS_API_KEY (learn how to configure secrets)
CursorAgentsApi.ListGithubRepositories
Retrieve accessible GitHub repositories for a user.
Parameters
This tool does not take any parameters. Secrets
This tool requires the following secrets: CURSOR_AGENTS_API_KEY (learn how to configure secrets)