Enterprise AI Spend Tracking Plugin for Cursor
Cursor Usage - Enterprise AI Spend Tracking Plugin
An MCP server plugin that wraps the Cursor Enterprise API. Ask your AI agent about your team's spending, usage, and model adoption. Get answers in seconds, not spreadsheets.

Demo animation created with remotion-readme-kit
What This Does
You manage a Cursor Enterprise team. You want to know who's spending what, which models are being used, and whether you're getting value from AI. Instead of logging into a dashboard, you ask your AI agent:
"How much did my team spend this week?"
"Who's using the most expensive models?"
"Give me a full usage report for the current billing cycle."
This MCP server plugin wraps the full Cursor Enterprise Admin and Analytics APIs, giving your agent the tools and knowledge to answer those questions directly. Works with Cursor, Claude Code, and any MCP-compatible client.
Part of the cursor-usage-tracker ecosystem. This plugin handles quick questions in the IDE. The tracker is the full open-source dashboard with charts, three-layer anomaly detection, Slack/email alerts, and incident lifecycle tracking. Use them together or separately.
What's Included
| Component | What it does |
|---|---|
| MCP Server | 15 tools wrapping the full Cursor Enterprise Admin + Analytics API |
| Skills | Data interpretation guide + cost optimization framework |
| Rules | Always-on cost-awareness guidance for model selection |
| Commands | Quick-access: /usage-report, /spend-check, /model-audit |
| Agent | Specialized usage analyst persona |
Install
Cursor (Marketplace)
/add-plugin cursor-usage
Then set your API key in Cursor settings:
- Open Settings → MCP
- Find
cursor-usageand setCURSOR_API_KEYto your Cursor Enterprise Admin API key
Claude Code
/plugin install cursor-usage
Manual (any MCP-compatible client)
Add to your MCP configuration:
{
"mcpServers": {
"cursor-usage": {
"command": "npx",
"args": ["-y", "cursor-usage-mcp"],
"env": {
"CURSOR_API_KEY": "your-api-key-here"
}
}
}
}
As a Skill Only (no MCP server)
Copy the skills/ directory into your project's .cursor/skills/ or .claude/skills/ folder. The skills work standalone as reference material even without the MCP server.
Getting Your API Key
- Go to your Cursor team settings (Settings → Team → API Keys)
- Generate an Admin API key
- For analytics endpoints, you may also need an Analytics API key
The API key gives read access to your team's usage data. The only write operation is set_spend_limit.
Available Tools
Admin API
| Tool | Description |
|---|---|
get_team_members |
List all team members with roles and status |
get_spending |
Current billing cycle spend per member |
get_daily_usage |
Daily usage data: lines, requests, models, modes |
get_billing_groups |
Billing groups with member lists and spend |
get_usage_events |
Per-request events with model, tokens, and costs |
set_spend_limit |
Set a hard spending limit for a user |
Analytics API
| Tool | Description |
|---|---|
get_dau |
Daily active users (include |
Tools (7)
get_team_membersList all team members with roles and statusget_spendingCurrent billing cycle spend per memberget_daily_usageDaily usage data: lines, requests, models, modesget_billing_groupsBilling groups with member lists and spendget_usage_eventsPer-request events with model, tokens, and costsset_spend_limitSet a hard spending limit for a userget_dauGet daily active usersEnvironment Variables
CURSOR_API_KEYrequiredYour Cursor Enterprise Admin API keyConfiguration
{"mcpServers": {"cursor-usage": {"command": "npx", "args": ["-y", "cursor-usage-mcp"], "env": {"CURSOR_API_KEY": "your-api-key-here"}}}}