{"id":28918345,"url":"https://github.com/h3ro-dev/cursor-admin-mcp","last_synced_at":"2026-04-29T14:02:37.629Z","repository":{"id":300120867,"uuid":"1005262262","full_name":"h3ro-dev/cursor-admin-mcp","owner":"h3ro-dev","description":"Model Context Protocol server for Cursor Admin API - instant team analytics power-up for AI assistants","archived":false,"fork":false,"pushed_at":"2025-06-20T00:56:32.000Z","size":99,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-20T01:28:08.331Z","etag":null,"topics":["api-client","cursor","cursor-ide","developer-tools","mcp","model-context-protocol","team-analytics","typescript"],"latest_commit_sha":null,"homepage":"https://github.com/h3ro-dev/cursor-admin-mcp#readme","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/h3ro-dev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-20T00:26:47.000Z","updated_at":"2025-06-20T00:56:35.000Z","dependencies_parsed_at":"2025-06-20T01:28:28.485Z","dependency_job_id":"db3e783a-1fce-479c-9a3e-c4cc0487c3cc","html_url":"https://github.com/h3ro-dev/cursor-admin-mcp","commit_stats":null,"previous_names":["h3ro-dev/cursor-admin-mcp"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/h3ro-dev/cursor-admin-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/h3ro-dev%2Fcursor-admin-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/h3ro-dev%2Fcursor-admin-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/h3ro-dev%2Fcursor-admin-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/h3ro-dev%2Fcursor-admin-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/h3ro-dev","download_url":"https://codeload.github.com/h3ro-dev/cursor-admin-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/h3ro-dev%2Fcursor-admin-mcp/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261224293,"owners_count":23126930,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-client","cursor","cursor-ide","developer-tools","mcp","model-context-protocol","team-analytics","typescript"],"created_at":"2025-06-22T02:02:45.472Z","updated_at":"2026-04-29T14:02:37.624Z","avatar_url":"https://github.com/h3ro-dev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cursor Admin MCP Server\n\n\u003cdiv align=\"center\"\u003e\n  \n  \u003cimg src=\"assets/utlyze-logo.png\" alt=\"Utlyze Logo\" width=\"300\"\u003e\n  \n  ## by [Utlyze.com](https://utlyze.com)\n  \n  [![npm version](https://img.shields.io/npm/v/cursor-admin-mcp.svg)](https://www.npmjs.com/package/cursor-admin-mcp)\n  [![npm downloads](https://img.shields.io/npm/dm/cursor-admin-mcp.svg)](https://www.npmjs.com/package/cursor-admin-mcp)\n  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n  [![Build Status](https://github.com/h3ro-dev/cursor-admin-mcp/workflows/CI/badge.svg)](https://github.com/h3ro-dev/cursor-admin-mcp/actions)\n  [![Test Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen.svg)](./coverage)\n  \n  **🎮 The Team Analytics Power-Up for Your AI Assistant**\n  \n  *Brought to you by [Utlyze](https://utlyze.com) - Zero Latency Operations Through AI Employees*\n  \n\u003c/div\u003e\n\n## 🚀 Quick Install\n\n```bash\nnpx -y cursor-admin-mcp\n```\n\nThat's it. Your AI assistant just leveled up.\n\n## 🎯 What You Get\n\nThink of this as equipping your AI with X-ray vision for your development team:\n\n- **🏢 Team Roster** - Instantly know who's on the team and their roles\n- **📊 Usage Analytics** - See who's actually coding vs. who's in meetings\n- **💰 Credit Tracker** - Know exactly where your AI credits are going\n- **📈 Productivity Metrics** - Lines added, AI acceptance rates, favorite models\n- **🔍 Deep Insights** - Which developer uses which tools, when they're most active\n\n## 💪 Why This Matters\n\nStop asking your team for status updates. Your AI can now tell you:\n- \"Who wrote the most code this week?\"\n- \"What's our AI spending trend?\"\n- \"Which team member has the highest AI acceptance rate?\"\n- \"Show me usage patterns for the last month\"\n\n## 📸 See It In Action\n\n```\nYou: \"Show me team usage for this week\"\n\nAI: Here's your team's activity for the last 7 days:\n\n👥 TEAM MEMBERS\n1. James Brady (Owner) - james@jamesbrady.org\n2. Cody Vincent - vincent.cody298@gmail.com\n3. 2 other members\n\n📊 USAGE STATISTICS\n• Most Active: Cody Vincent (641 AI requests)\n• Most Productive: Cody Vincent (29,477 lines added)\n• Top Models: claude-4-opus, gpt-4, claude-sonnet\n• Active Days: 2/4 members coding daily\n\n💰 SPENDING: $1,957.32 total\n• James Brady: $1,848.57 (94.4%)\n• Cody Vincent: $73.76 (3.8%)\n• Others: $34.99 (1.8%)\n```\n\n## Installation\n\n### Prerequisites\n\n- Node.js 16+ \n- A Cursor team admin API key (get it from your team settings)\n\n### Install from npm\n\n```bash\nnpm install -g cursor-admin-mcp\n```\n\n### Install from source\n\n```bash\ngit clone https://github.com/h3ro-dev/cursor-admin-mcp.git\ncd cursor-admin-mcp\nnpm install\nnpm run build\n```\n\n## Configuration\n\n### 1. Set up your API key\n\nCreate a `.env` file in the project root (or set the environment variable):\n\n```env\nCURSOR_API_KEY=key_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n```\n\n### 2. Configure in Claude Desktop\n\nAdd to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"cursor-admin\": {\n      \"command\": \"npx\",\n      \"args\": [\"cursor-admin-mcp\"],\n      \"env\": {\n        \"CURSOR_API_KEY\": \"key_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"\n      }\n    }\n  }\n}\n```\n\n### 3. Configure in Cursor\n\nAdd to your Cursor settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"cursor-admin\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/cursor-admin-mcp/dist/index.js\"],\n      \"env\": {\n        \"CURSOR_API_KEY\": \"key_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\n### 1. `get_team_members`\n\nGet a list of all team members with their information.\n\n**Example usage in Claude/Cursor:**\n```\n\"Show me all team members\"\n\"List everyone on the team with their roles\"\n```\n\n**Returns:**\n```json\n[\n  {\n    \"name\": \"John Doe\",\n    \"email\": \"john@example.com\",\n    \"role\": \"admin\"\n  },\n  {\n    \"name\": \"Jane Smith\",\n    \"email\": \"jane@example.com\",\n    \"role\": \"member\"\n  }\n]\n```\n\n### 2. `get_daily_usage_data`\n\nRetrieve detailed usage metrics for a specified date range (max 90 days).\n\n**Parameters:**\n- `startDate`: Start date in epoch milliseconds\n- `endDate`: End date in epoch milliseconds\n\n**Example usage in Claude/Cursor:**\n```\n\"Show me usage data for the last 7 days\"\n\"What was our team's AI acceptance rate last month?\"\n\"Which models did we use most this week?\"\n```\n\n**Returns:**\n```json\n[\n  {\n    \"date\": \"2024-01-15\",\n    \"linesAdded\": 1523,\n    \"linesDeleted\": 342,\n    \"acceptanceRate\": 0.82,\n    \"requestTypes\": {\n      \"completion\": 234,\n      \"chat\": 56,\n      \"edit\": 23\n    },\n    \"mostUsedModels\": [\"gpt-4\", \"claude-3\"],\n    \"mostUsedExtensions\": [\"copilot\", \"cursor-tab\"],\n    \"clientVersion\": \"0.42.0\"\n  }\n]\n```\n\n### 3. `get_spending_data`\n\nGet team spending information with optional filtering and pagination.\n\n**Optional Parameters:**\n- `searchTerm`: Filter by search term\n- `sortBy`: Field to sort by\n- `sortDirection`: \"asc\" or \"desc\"\n- `page`: Page number\n- `pageSize`: Items per page\n\n**Example usage in Claude/Cursor:**\n```\n\"Show me team spending\"\n\"Who are the top spenders this month?\"\n\"Search for John's spending data\"\n```\n\n**Returns:**\n```json\n{\n  \"members\": [\n    {\n      \"email\": \"john@example.com\",\n      \"name\": \"John Doe\",\n      \"spending\": 125.50\n    }\n  ],\n  \"total\": 1250.00,\n  \"page\": 1,\n  \"pageSize\": 10\n}\n```\n\n## Development\n\n### Setup\n\n```bash\n# Clone the repository\ngit clone https://github.com/h3ro-dev/cursor-admin-mcp.git\ncd cursor-admin-mcp\n\n# Install dependencies\nnpm install\n\n# Copy environment file\ncp .env.example .env\n# Edit .env and add your CURSOR_API_KEY\n\n# Run in development mode\nnpm run dev\n```\n\n### Testing\n\n```bash\n# Run tests\nnpm test\n\n# Run tests with coverage\nnpm test -- --coverage\n\n# Run tests in watch mode\nnpm run test:watch\n```\n\n### Building\n\n```bash\n# Build the project\nnpm run build\n\n# Run the built version\nnpm start\n```\n\n### Project Structure\n\n```\ncursor-admin-mcp/\n├── src/\n│   ├── index.ts          # MCP server implementation\n│   └── cursor-client.ts  # Cursor API client\n├── tests/\n│   └── cursor-client.test.ts  # Test suite\n├── examples/\n│   └── (example scripts)\n├── docs/\n│   └── (additional documentation)\n├── package.json\n├── tsconfig.json\n├── jest.config.js\n├── .env.example\n├── .gitignore\n└── README.md\n```\n\n## Examples\n\n### Basic Usage\n\n```typescript\n// The MCP server handles all the communication\n// Just use natural language in Claude/Cursor:\n\n\"Show me all team members and their roles\"\n\"Get usage data for January 2024\"\n\"What's our team's total spending this month?\"\n\"Show me the AI acceptance rate trend for the last 30 days\"\n```\n\n### Advanced Queries\n\n```typescript\n// Complex date ranges\n\"Compare usage between last week and this week\"\n\n// Specific metrics\n\"Which team members have the highest AI suggestion acceptance rate?\"\n\n// Spending analysis\n\"Show me spending sorted by amount for team members whose name contains 'John'\"\n```\n\n## Error Handling\n\nThe server includes comprehensive error handling:\n\n- **Invalid API Key**: Clear error message if authentication fails\n- **Rate Limiting**: Respects Cursor API rate limits\n- **Date Validation**: Ensures date ranges don't exceed 90 days\n- **Network Errors**: Graceful handling of connection issues\n- **Invalid Parameters**: Detailed validation messages\n\n## Security\n\n- API keys are never logged or exposed\n- All communication uses HTTPS\n- Basic authentication as per Cursor API requirements\n- Environment variables for sensitive data\n\n## Contributing\n\nContributions are welcome! Please:\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n### Development Guidelines\n\n- Write tests for new features\n- Update documentation\n- Follow TypeScript best practices\n- Ensure all tests pass\n- Add examples for new functionality\n\n## Troubleshooting\n\n### API Key Issues\n\nIf you get authentication errors:\n1. Verify your API key starts with `key_`\n2. Ensure you're a team admin\n3. Check the key hasn't been revoked\n\n### Connection Issues\n\nIf the server won't connect:\n1. Check your internet connection\n2. Verify the Cursor API is accessible\n3. Check for any firewall restrictions\n\n### Date Range Errors\n\nIf you get date range errors:\n1. Ensure your date range is within 90 days\n2. Use epoch milliseconds for dates\n3. Verify endDate \u003e startDate\n\n## License\n\nMIT License - see LICENSE file for details\n\n## Acknowledgments\n\n- Built for the [Cursor](https://cursor.com) editor\n- Implements the [Model Context Protocol](https://modelcontextprotocol.io)\n- Uses the official [MCP SDK](https://github.com/modelcontextprotocol/sdk)\n\n## Support\n\n- 🐛 [Report bugs](https://github.com/h3ro-dev/cursor-admin-mcp/issues)\n- 💡 [Request features](https://github.com/h3ro-dev/cursor-admin-mcp/issues)\n- 📖 [Read the docs](https://github.com/h3ro-dev/cursor-admin-mcp/wiki)\n- 💬 [Join discussions](https://github.com/h3ro-dev/cursor-admin-mcp/discussions)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \n## Built by [Utlyze](https://utlyze.com)\n\n**Utlyze - Zero Latency Operations Through AI Employees**\n\nWe're pioneering the future of work by creating AI employees that seamlessly integrate with your existing workflows. The Cursor Admin MCP Server is just one example of how we're making teams more efficient through intelligent automation.\n\n[Visit Utlyze.com](https://utlyze.com) | [Contact Us](mailto:support@utlyze.com) | [LinkedIn](https://linkedin.com/company/utlyze)\n\nMade with ❤️ by the Utlyze team for the Cursor community\n\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fh3ro-dev%2Fcursor-admin-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fh3ro-dev%2Fcursor-admin-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fh3ro-dev%2Fcursor-admin-mcp/lists"}