Cursor Usage MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add -e "CURSOR_API_KEY=${CURSOR_API_KEY}" cursor-usage -- npx -y cursor-usage-mcp
Required:CURSOR_API_KEY
README.md

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

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-usage and set CURSOR_API_KEY to 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

  1. Go to your Cursor team settings (Settings → Team → API Keys)
  2. Generate an Admin API key
  3. 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 status
get_spendingCurrent billing cycle spend per member
get_daily_usageDaily usage data: lines, requests, models, modes
get_billing_groupsBilling groups with member lists and spend
get_usage_eventsPer-request events with model, tokens, and costs
set_spend_limitSet a hard spending limit for a user
get_dauGet daily active users

Environment Variables

CURSOR_API_KEYrequiredYour Cursor Enterprise Admin API key

Configuration

claude_desktop_config.json
{"mcpServers": {"cursor-usage": {"command": "npx", "args": ["-y", "cursor-usage-mcp"], "env": {"CURSOR_API_KEY": "your-api-key-here"}}}}

Try it

How much did my team spend this week?
Who is using the most expensive models in our team?
Give me a full usage report for the current billing cycle.
List all team members and their current spending status.
Set a spending limit for the user with the highest usage.

Frequently Asked Questions

What are the key features of Cursor Usage?

Wraps Cursor Enterprise Admin and Analytics APIs. Provides real-time team spending and model adoption insights. Includes data interpretation guide and cost optimization framework. Supports per-request event tracking including tokens and costs. Allows setting hard spending limits for team members.

What can I use Cursor Usage for?

Monitoring team AI spending to stay within budget. Identifying which team members are using the most expensive AI models. Generating usage reports for billing cycles without manual spreadsheet work. Auditing model adoption to optimize AI tool investment.

How do I install Cursor Usage?

Install Cursor Usage by running: /add-plugin cursor-usage

What MCP clients work with Cursor Usage?

Cursor Usage works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Cursor Usage docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare