convez.ai
PluginDados & AnalyticsIntermediário
ofershap

Cursor Usage - Rastreador de Gasto Enterprise

ofershap/cursor-usage

Consulte gastos e uso de IA do seu time diretamente no agente

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server que integra a API Cursor Enterprise para monitorar gastos, uso e adoção de modelos do seu time em tempo real. Permite consultar dados de spending, análises de uso e relatórios via chat com o agente de IA, eliminando a necessidade de acessar dashboards.

Instalação

$npx convez-ai ofershap/cursor-usage

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
8
Forks
2
Acompanhando
1
Saúde
42%
Último commit
há 9 meses
Versão
—
Issues abertas
1
Contribuidores
1

Casos de uso

  • Monitorar spending semanal/mensal de times com Cursor Enterprise
  • Auditar adoção de modelos e identificar padrões de uso
  • Gerar relatórios de custo-benefício de modelos IA para stakeholders
  • Controlar gastos em tempo real durante desenvolvimento

Veredito

Solução sólida para times Cursor Enterprise que precisam visibilidade de spending sem deixar o IDE. A integração MCP é técnica e bem implementada, mas público é limitado a usuários com Enterprise.

README

A tradução para o português deste README ainda está na fila.


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

ComponentWhat it does
MCP Server15 tools wrapping the full Cursor Enterprise Admin + Analytics API
SkillsData interpretation guide + cost optimization framework
RulesAlways-on cost-awareness guidance for model selection
CommandsQuick-access: /usage-report, /spend-check, /model-audit
AgentSpecialized 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

ToolDescription
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

Analytics API

ToolDescription
get_dauDaily active users (includes CLI, cloud agent, Bugbot)
get_model_usageModel usage breakdown per day
get_agent_editsAgent edit acceptance/rejection rates
get_tabsTab autocomplete effectiveness
get_mcp_usageMCP tool adoption
get_file_extensionsTop file types being edited with AI
get_client_versionsCursor version distribution
get_commandsCommand usage analytics
get_plansPlan mode adoption

Composite Tools

ToolDescription
get_team_overviewOne-call summary: members, spend, DAU, top models
get_user_deep_diveDeep dive into a specific user's usage patterns

Example Conversations

Quick spend check:

You: "How much has my team spent this billing cycle?" Agent: calls get_team_overview → "Your team of 47 active members has spent $3,842 this cycle. Top spender is Alice at $412, followed by Bob at $287..."

User investigation:

You: "Why is Bob's spend so high?" Agent: calls get_user_deep_dive → "Bob has made 847 requests this week, 73% using claude-opus-4.5. His daily average is $41 vs the team median of $12. Switching his chat requests to Sonnet would save approximately $180/month..."

Model audit:

You: "/model-audit" Agent: calls get_model_usage + get_spending + get_agent_edits → "62% of your team's messages use Sonnet (good). However, 5 users account for 78% of all Opus usage. Their acceptance rate on Opus is 44% vs 51% on Sonnet, suggesting Opus isn't providing measurably better results for most of their tasks..."

Full Cursor Enterprise Cost Monitoring Dashboard

This plugin answers quick questions in the IDE. For teams that need:

  • Historical trends over months (API is limited to 30 days)
  • Automated anomaly detection with statistical outlier detection
  • Slack/email alerts when spend spikes
  • Incident tracking with MTTD/MTTI/MTTR lifecycle
  • Web dashboard with charts and visualizations

See cursor-usage-tracker, the open-source Cursor Enterprise dashboard this plugin is part of.

Development

# Install dependencies
npm install

# Run in development
npm run dev

# Build
npm run build

# Type check
npm run typecheck

# Run tests
npm test

# Validate plugin structure
npm run validate

Requirements

  • Node.js 20+
  • A Cursor Enterprise team with API access
  • Admin API key (and optionally Analytics API key)

Author

Ofer Shapira

LinkedIn GitHub

License

MIT © Ofer Shapira

Ver o original no GitHub

Bom para

Relacionados