ofershap/cursor-usage

ofershap/cursor-usage

от ofershap
MCP-сервер для Cursor Enterprise, позволяющий AI-агенту отслеживать расходы команды, использование моделей и активность. Умеет отвечать на вопросы о тратах и давать рекомендации по оптимизации. Пол...

Cursor Usage - MCP server plugin for Cursor Enterprise API spending and analytics

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.

CI License: MIT TypeScript MCP npm Dashboard


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.

Инструменты были проиндексированы:
get_agent_edits

Получить метрики редактирования агентом: предложенные, принятые и отклонённые диффы и строки. Показывает, насколько эффективно команда использует код, сгенерированный ИИ.

Параметры
  • endDatestring

    Конечная дата. Форматы: "YYYY-MM-DD", "today", "yesterday". По умолчанию: "today"

  • startDatestring

    Дата начала. Форматы: "YYYY-MM-DD", "7d", "30d", "today", "yesterday". По умолчанию: "30d"

  • usersstring

    Адреса электронной почты через запятую для фильтрации по конкретным пользователям.

get_billing_groups

Возвращает платежные группы: список участников, расходы по группам и ежедневную разбивку расходов. Также возвращает даты расчетных периодов.

Параметры

Без параметров.

get_client_versions

Получить распределение версий клиента Cursor по команде: какие версии используются и какой процент пользователей на каждой из них.

Параметры
  • endDatestring

    Конечная дата. Форматы: "YYYY-MM-DD", "today", "yesterday". По умолчанию: "today"

  • startDatestring

    Дата начала. Форматы: "YYYY-MM-DD", "7d", "30d", "today", "yesterday". По умолчанию: "30d"

  • usersstring

    Адреса электронной почты через запятую для фильтрации по конкретным пользователям.

get_commands

Получить аналитику использования команд: какие команды Cursor используются и как часто.

Параметры
  • endDatestring

    Конечная дата. Форматы: "YYYY-MM-DD", "today", "yesterday". По умолчанию: "today"

  • startDatestring

    Дата начала. Форматы: "YYYY-MM-DD", "7d", "30d", "today", "yesterday". По умолчанию: "30d"

  • usersstring

    Адреса электронной почты через запятую для фильтрации по конкретным пользователям.

get_daily_usage

Получает ежедневные данные об использовании на пользователя: добавленные/удалённые строки, применения, принятия, отклонения, вкладки, запросы по режиму (composer/chat/agent), используемые модели и версии клиентов.

Параметры
  • allPagesboolean

    Загружать все страницы автоматически (по умолчанию: false)

  • endDatenumber

    Дата окончания в виде временной метки Unix в миллисекундах.

  • pagenumber

    Номер страницы, по умолчанию 1

  • pageSizenumber

    Результатов на странице (1-50). По умолчанию: 20.

  • startDatenumber

    Дата начала в виде Unix timestamp в миллисекундах.

get_dau

Получает количество ежедневно активных пользователей за период, включая разбивку по использованию CLI, cloud agent и Bugbot.

Параметры
  • endDatestring

    Конечная дата. Форматы: "YYYY-MM-DD", "today", "yesterday". По умолчанию: "today"

  • startDatestring

    Дата начала. Форматы: "YYYY-MM-DD", "7d", "30d", "today", "yesterday". По умолчанию: "30d"

  • usersstring

    Адреса электронной почты через запятую для фильтрации по конкретным пользователям.

get_file_extensions

Получить самые популярные расширения файлов, редактируемых с помощью ИИ: какие типы файлов получают больше всего предложений ИИ, принятий и отклонений.

Параметры
  • endDatestring

    Конечная дата. Форматы: "YYYY-MM-DD", "today", "yesterday". По умолчанию: "today"

  • startDatestring

    Дата начала. Форматы: "YYYY-MM-DD", "7d", "30d", "today", "yesterday". По умолчанию: "30d"

  • usersstring

    Адреса электронной почты через запятую для фильтрации по конкретным пользователям.

get_mcp_usage

Получить использование инструментов MCP (Model Context Protocol): какие серверы и инструменты MCP используются и как часто.

Параметры
  • endDatestring

    Конечная дата. Форматы: "YYYY-MM-DD", "today", "yesterday". По умолчанию: "today"

  • startDatestring

    Дата начала. Форматы: "YYYY-MM-DD", "7d", "30d", "today", "yesterday". По умолчанию: "30d"

  • usersstring

    Адреса электронной почты через запятую для фильтрации по конкретным пользователям.

get_model_usage

Получает разбивку использования моделей по дням: какие модели используются, сколько сообщений и сколько пользователей. Необходимо для понимания внедрения моделей и факторов затрат.

Параметры
  • endDatestring

    Конечная дата. Форматы: "YYYY-MM-DD", "today", "yesterday". По умолчанию: "today"

  • startDatestring

    Дата начала. Форматы: "YYYY-MM-DD", "7d", "30d", "today", "yesterday". По умолчанию: "30d"

  • usersstring

    Адреса электронной почты через запятую для фильтрации по конкретным пользователям.

get_plans

Получает данные об использовании режима планирования: какие модели применяются в этом режиме и как часто.

Параметры
  • endDatestring

    Конечная дата. Форматы: "YYYY-MM-DD", "today", "yesterday". По умолчанию: "today"

  • startDatestring

    Дата начала. Форматы: "YYYY-MM-DD", "7d", "30d", "today", "yesterday". По умолчанию: "30d"

  • usersstring

    Адреса электронной почты через запятую для фильтрации по конкретным пользователям.

get_spending

Получить текущие расходы за расчетный период для всех членов команды. Показывает расходы в долларах, включенные и превышенные, быстрые премиум-запросы и лимиты расходов.

Параметры
  • allPagesboolean

    Загружать все страницы автоматически (по умолчанию: false)

  • pagenumber

    Номер страницы, по умолчанию 1

get_tabs

Получить данные об использовании автодополнения Tab: показанные предложения, принятые и отклонённые, с детализацией по строкам.

Параметры
  • endDatestring

    Конечная дата. Форматы: "YYYY-MM-DD", "today", "yesterday". По умолчанию: "today"

  • startDatestring

    Дата начала. Форматы: "YYYY-MM-DD", "7d", "30d", "today", "yesterday". По умолчанию: "30d"

  • usersstring

    Адреса электронной почты через запятую для фильтрации по конкретным пользователям.

get_team_members

Выводит список всех участников команды с их ролями и статусом. Возвращает имя, email, роль и информацию о том, был ли участник удалён.

Параметры

Без параметров.

get_team_overview

Получает полный обзор команды: количество участников, общие расходы, лидеры по расходам, DAU и наиболее часто используемые модели. Это лучшая отправная точка для понимания того, как ваша команда использует Cursor.

Параметры
  • endDatestring

    Analytics date range end (по умолчанию: 'today')

  • startDatestring

    Начало диапазона дат аналитики (по умолчанию: "7d")

get_usage_events

Получает детальные события использования по каждому запросу с указанием модели, количества токенов, стоимости и того, был ли запрос платным. Поддерживает фильтрацию по email пользователя и диапазону дат.

Параметры
  • emailstring

    Фильтрует по email пользователя.

  • endDatenumber

    Дата окончания в виде временной метки Unix в миллисекундах.

  • pagenumber

    Номер страницы, по умолчанию 1

  • pageSizenumber

    Результатов на странице (по умолчанию: 10, макс.: 25)

  • startDatenumber

    Дата начала в виде Unix timestamp в миллисекундах.

get_user_deep_dive

Подробный анализ использования конкретного пользователя: его расходы, ежедневные сценарии использования, недавние запросы и предпочтения моделей.

Параметры
  • emailstringобязательный

    Электронное письмо пользователя для анализа

  • startDatestring

    Начало диапазона дат аналитики (по умолчанию: "7d")

set_spend_limit

Установить жесткий лимит расходов (в долларах) для конкретного члена команды. Используйте с осторожностью - это заблокирует пользователю возможность отправлять запросы после достижения лимита.

Параметры
  • emailstringобязательный

    Электронная почта пользователя, для которого устанавливается лимит.

  • limitDollarsnumberобязательный

    Жесткий лимит расходов в долларах (0 для снятия лимита)

0.1.2основная
0.1.1
0.1.0

Выберите клиент, чтобы установить ofershap/cursor-usage:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "ofershap-cursor-usage-nlavueq863": {
      "command": "npx",
      "args": [
        "-y",
        "cursor-usage-mcp"
      ],
      "env": {
        "CURSOR_API_KEY": "your-api-key-here"
      }
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "ofershap-cursor-usage-nlavueq863": {
      "command": "npx",
      "args": [
        "-y",
        "cursor-usage-mcp"
      ],
      "env": {
        "CURSOR_API_KEY": "your-api-key-here"
      }
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "ofershap-cursor-usage-nlavueq863": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "cursor-usage-mcp"
      ],
      "env": {
        "CURSOR_API_KEY": "your-api-key-here"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"ofershap-cursor-usage-nlavueq863\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"cursor-usage-mcp\"],\"env\":{\"CURSOR_API_KEY\":\"your-api-key-here\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "ofershap-cursor-usage-nlavueq863": {
      "command": "npx",
      "args": [
        "-y",
        "cursor-usage-mcp"
      ],
      "env": {
        "CURSOR_API_KEY": "your-api-key-here"
      }
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add ofershap-cursor-usage-nlavueq863 --env CURSOR_API_KEY=your-api-key-here -- npx -y cursor-usage-mcp

Либо через JSON-конфиг:

claude mcp add-json ofershap-cursor-usage-nlavueq863 "{\"command\":\"npx\",\"args\":[\"-y\",\"cursor-usage-mcp\"],\"env\":{\"CURSOR_API_KEY\":\"your-api-key-here\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add ofershap-cursor-usage-nlavueq863 --env CURSOR_API_KEY=your-api-key-here -- npx -y cursor-usage-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.ofershap-cursor-usage-nlavueq863]
command = "npx"
args = ["-y", "cursor-usage-mcp"]

[mcp_servers.ofershap-cursor-usage-nlavueq863.env]
CURSOR_API_KEY = "your-api-key-here"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите ofershap/cursor-usage, а в поле команды запуска — строку ниже:
npx -y cursor-usage-mcp

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "ofershap-cursor-usage-nlavueq863": {
      "command": "npx",
      "args": [
        "-y",
        "cursor-usage-mcp"
      ],
      "env": {
        "CURSOR_API_KEY": "your-api-key-here"
      }
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "ofershap-cursor-usage-nlavueq863": {
      "command": "npx",
      "args": [
        "-y",
        "cursor-usage-mcp"
      ],
      "env": {
        "CURSOR_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например ofershap-cursor-usage-nlavueq863.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: ofershap-cursor-usage-nlavueq863
    command: npx
    args:
      - "-y"
      - "cursor-usage-mcp"
    env:
      CURSOR_API_KEY: your-api-key-here
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "ofershap-cursor-usage-nlavueq863": {
      "command": "npx",
      "args": [
        "-y",
        "cursor-usage-mcp"
      ],
      "env": {
        "CURSOR_API_KEY": "your-api-key-here"
      }
    }
  }
}

Похожие MCP-сервера

metrxbots/mcp-server

metrxbots/mcp-server

от metrxbots

Metrx - MCP-сервер для контроля затрат AI-агентов. Агенты отслеживают расходы, оптимизируют модели и доказывают ROI. Включает 23 инструмента для мониторинга, оптимизации и аудита. Полезен командам,...

TypeScript⭐ 2
smigolsmigol/llmkit

smigolsmigol/llmkit

от smigolsmigol

MCP-сервер для мониторинга затрат на AI-запросы в Claude Code, Cline, Cursor. 11 инструментов: прокси-аналитика, локальные расходы, прогноз бюджета. Помогает разработчикам AI-агентов контролировать...

TypeScript⭐ 16
VictoriaMetrics-Community/mcp-victorialogs

VictoriaMetrics-Community/mcp-victorialogs

официальный

от victoriametrics-community

MCP-сервер для VictoriaLogs. Предоставляет AI-агентам доступ к чтению логов, метрик, полей и встроенной документации через LogsQL-запросы. Упрощает отладку и мониторинг для инженеров.

Go⭐ 103
Comet-ML/Opik-MCP

Comet-ML/Opik-MCP

официальный

от comet-ml

MCP сервер для Opik – подключает AI-ассистентов (Claude Code, Cursor, VS Code) к вашему рабочему пространству: читайте трейсы, логируйте оценки, сохраняйте версии промптов и задавайте вопросы ассис...

Python⭐ 223
context-rot-detection

context-rot-detection

от milos-product-maker

MCP инструмент, дающий AI-агентам самосознание: измеряет деградацию когнитивного здоровья при заполнении контекста. Разработчики применяют его для выявления context rot и получения рекомендаций.

TypeScript⭐ 13
whdrnr2583-cmd/token-meter

whdrnr2583-cmd/token-meter

от whdrnr2583-cmd

MCP сервер для локального отслеживания токенов и стоимости Claude Code, Codex и Cursor. Анализирует JSONL файлы и показывает разбивку по проектам, моделям и MCP инструментам — без отправки данных в облако и без аккаунта.

TypeScript⭐ 1
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин