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 Server provides tools for managing and inspecting background , authentication info, model recommendations, and linked GitHub repos. These let and LLMs:
- List, inspect, and delete background .
- Retrieve an ’s current status, results, and full conversation history.
- Verify / info used for authentication.
- Fetch recommended models for background .
- List GitHub repositories accessible to the authenticated .
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 , or create your own tools.
CursorAgentsApi.ListBackgroundAgents
List all background for the .
Parameters
- agent_limit (
integer, optional) Number of background to return for the request. - pagination_cursor (
string, optional) Pagination cursor from the previous response to navigate pages.
Secrets
This requires the following secrets: CURSOR_AGENTS_API_KEY (learn how to configure secrets)
CursorAgentsApi.GetAgentStatus
Retrieve the current status and results of a background .
Parameters
- background_agent_id (
string, required) A unique identifier required to retrieve the status and results of the specified background .
Secrets
This requires the following secrets: CURSOR_AGENTS_API_KEY (learn how to configure secrets)
CursorAgentsApi.DeleteBackgroundAgent
Permanently delete a background .
Parameters
- background_agent_id (
string, required) Unique identifier for the background to be deleted permanently.
Secrets
This requires the following secrets: CURSOR_AGENTS_API_KEY (learn how to configure secrets)
CursorAgentsApi.GetAgentConversationHistory
Retrieve the conversation history of a background .
Parameters
- background_agent_id (
string, required) Unique identifier for the background to retrieve conversation history.
Secrets
This requires the following secrets: CURSOR_AGENTS_API_KEY (learn how to configure secrets)
CursorAgentsApi.RetrieveApiUserInfo
Retrieve information about the used for authentication.
Parameters
This does not take any parameters. Secrets
This requires the following secrets: CURSOR_AGENTS_API_KEY (learn how to configure secrets)
CursorAgentsApi.ListRecommendedModels
Retrieve recommended models for background .
Parameters
This does not take any parameters. Secrets
This requires the following secrets: CURSOR_AGENTS_API_KEY (learn how to configure secrets)
CursorAgentsApi.ListGithubRepositories
Retrieve accessible GitHub repositories for a .
Parameters
This does not take any parameters. Secrets
This requires the following secrets: CURSOR_AGENTS_API_KEY (learn how to configure secrets)