Cursor Admin

You set up a Cursor Admin MCP Server to empower your AI assistant with team analytics, usage insights, and spending visibility. This server lets Claude or Cursor query your team data and receive actionable metrics in natural language, so you can answer questions about who coded what, how spending trends look, and which models your team favors.

How to use

Interact with the MCP using your preferred client (Claude/Cursor) by asking natural language questions about your team data. You can request team composition, daily usage metrics, spending, productivity trends, and deep insights about tool usage. Typical practices include asking for the most active team member this week, viewing usage patterns over a time range, or comparing spending between teammates. All requests are handled by the MCP server and translated into concrete metrics you define in plain language.

How to install

Prerequisites: Node.js 16+ and a Cursor team admin API key.

# Install from npm (global)
npm install -g cursor-admin-mcp

# Or install via an executable run (optional quick-start)
npx -y cursor-admin-mcp

Configuration

Set up your API key and integrate the MCP with Claude Desktop or Cursor so your client can communicate with the MCP server.

env
CURSOR_API_KEY=key_your_api_key_here

# Claude Desktop configuration example
{
  "mcpServers": {
    "cursor-admin": {
      "command": "npx",
      "args": ["cursor-admin-mcp"],
      "env": {
        "CURSOR_API_KEY": "key_your_api_key_here"
      }
    }
  }
}

# Cursor configuration example
{
  "mcpServers": {
    "cursor-admin": {
      "command": "node",
      "args": ["/path/to/cursor-admin-mcp/dist/index.js"],
      "env": {
        "CURSOR_API_KEY": "key_your_api_key_here"
      }
    }
  }
}

Security & environment

The MCP server requires your API key to authenticate with the Cursor API. Environment variables are kept private and are not logged. All network communication uses HTTPS, and you should handle keys securely in your deployment.

Troubleshooting

If you encounter authentication or connection issues, verify your API key is valid and that the MCP server can reach the Cursor API. Check that your environment variables are correctly set in the client configuration.

Development & notes

Developers can run in development mode, build, and start the server to test changes locally. Use the provided scripts to install dependencies, build, and run the server.

Available tools

get_team_members

Returns a list of all team members with their name, email, and role (admin or member).

get_daily_usage_data

Fetches detailed usage data for a specified date range, including lines added, acceptance rate, and most used models/extensions.

get_spending_data

Retrieves spending information for team members with optional filtering, sorting, and pagination.