> For the complete documentation index, see [llms.txt](https://docs.revenium.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.revenium.io/track-and-control-costs/analyze-ai-tooling-spend/setup-cursor.md).

# Setup Cursor

Revenium tracks Cursor IDE usage by syncing data from the Cursor Admin API. Setup is through the Revenium dashboard, where the backend handles syncing automatically.

## Requirements

* Cursor IDE with an active subscription (Pro, Business, or Enterprise)
* A Cursor **Admin API key**, created by a team admin at cursor.com/dashboard → API Keys with admin access (`admin:*`). This is different from a personal user key.
* Revenium account with access to the Providers page

Connect your provider first: see [Connecting Providers](https://docs.revenium.io/get-started/quickstart/connecting-providers.md).

## 1. Add Cursor as a provider

1. In the Revenium dashboard, go to **Integrations > Providers**.
2. Select **Cursor** from the list of available providers.
3. Enter your **Cursor Admin API key**. A team admin creates it at cursor.com/dashboard → API Keys, and it grants access to the team usage API.
4. Save the configuration.

Once saved, Revenium syncs Cursor usage data automatically every 5 minutes. No CLI installation or local configuration is required.

{% hint style="info" %}
**Admin API key required.** Revenium reads team usage events through Cursor's Admin API, which needs a team-level key, not a personal one. Cursor API keys carry scopes: create the key with admin access (`admin:*`), which covers the usage data Revenium reads. A key without access to team usage is refused when you link it.
{% endhint %}

## 2. Verify data is flowing

After saving, allow up to 10 minutes for the first sync cycle to complete. Then check **Intelligence > AI Assistants > Cursor** in the dashboard to confirm usage data is appearing.

## On the dashboard

Open **Intelligence > AI Assistants > Cursor** to see what Cursor billed your team: the billed total with its change from the prior window and the request count, the split by Cursor billing category (such as **Usage-based** and **Included in Business**), and **Invoiced by person** and **Invoiced by model** tables. Invoice figures cover the whole team and cannot be split by department. The first sync may take up to 10 minutes.

## Troubleshooting

### No data appears after adding the provider

The backend syncs every 5 minutes. Allow up to 10 minutes for the first data to appear. If nothing shows after that:

1. Confirm you used a Cursor **Admin API key** created by a team admin, not a personal user key.
2. Verify the key in **Integrations > Providers > Cursor** is correct and has not been regenerated.
3. Confirm your Cursor subscription (Pro, Business, or Enterprise) is active.

### Cursor API key rejected

* The key must be a **Cursor Admin API key**, created by a team admin at cursor.com/dashboard → API Keys.
* Personal user API keys do not have access to the team usage endpoint.
* Cursor API keys carry scopes. Create the key with admin access (`admin:*`). A key that cannot read team usage is refused when you link it.
* Regenerate the key in Cursor if in doubt and update it in **Integrations > Providers**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.revenium.io/track-and-control-costs/analyze-ai-tooling-spend/setup-cursor.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
