Skip to main content
Glama

cursor-mcp

FastMCP 3.2 server for Cursor platform APIs — spend guardrails, cloud agent monitoring, and inter-agent inbox.

Complements cursor-app-control (IDE/Glass). Does not replace it.

Port

Role

11000

HTTP /mcp (Fritz fleet_bridge)

stdio

Cursor mcp.json / Claude Desktop

MCD: CHANGELOG_DIGEST_JUN_2026.md · CURSOR_MCP_PROPOSAL.md


Quick start

cd D:\Dev\repos\cursor-mcp
Copy-Item .env.example .env
# Edit .env — set CURSOR_API_KEY (and CURSOR_ADMIN_API_KEY for full spend API)

uv sync
.\start.ps1 -Serve

Cursor mcp.json

{
  "mcpServers": {
    "cursor-mcp": {
      "command": "D:\\Dev\\repos\\cursor-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "cursor_mcp", "--stdio"],
      "env": {
        "CURSOR_API_KEY": "cursor_...",
        "CURSOR_ADMIN_API_KEY": "crsr_..."
      }
    }
  }
}

Related MCP server: cursor-usage

Tools

cursor_usage

Operation

Purpose

alert_check

Main guardrail — hourly spend, on-demand, running cloud agents, cache delta

summary

One-shot dashboard replacement

spend

Admin API /teams/spend row

events

Last N hours usage events (sum chargedCents)

limits

Show configured thresholds

me

API key identity

cursor_cloud

Operation

Purpose

list

All cloud agents — spot runaway parallelism

status

Single agent

runs

Runs for agent

cancel

Cancel a run (use sparingly)

cursor_inbox

Structured message drop for Cursor agents. Any process posts; agent polls at task start.

Operation

Purpose

post

Drop a message (subject, body, priority, tags, optional payload dict)

list

Poll unread — call at agent task start

read

Full message by id

ack

Acknowledge (moves to inbox/acked/)

ack_all

Acknowledge all unread

purge

Delete acked messages older than N days

Drop dir: CURSOR_INBOX_DIR env (default ~/.cursor-mcp/inbox/). No daemon, no network — pure JSON files.

Who can write:

  • Claude Desktop: cursor_inbox post (add cursor-mcp to Claude Desktop MCP config)

  • meta_mcp / any fleet server: direct JSON file drop to CURSOR_INBOX_DIR

  • PowerShell / Python scripts: same

  • Sandra: cursor_inbox post from any MCP client

Cursor agent convention: add cursor_inbox list to AGENTS.md or Cursor rules so agents check for messages at the start of every session.

cursor_docs

Fleet snippets. Topics: cloud-agents, profiles, mcp-config, spend-guardrails, cursor-mcp, cursor-inbox, sdk-jun-2026, design-mode, auto-review, context-canvas, changelog-jun-2026.

cursor_sdk

Read-only SDK guidance (no agent spawn): capabilities, upgrade_notes, autoreview_template, custom_tools_guide, store_options.

Starter permissions: docs/permissions.fleet.example.json

cursor_help

Tool index and setup. Always current.


Auth notes

Key

Endpoints

CURSOR_API_KEY

/v1/me, /v1/agents/*

CURSOR_ADMIN_API_KEY

/teams/spend, /teams/filtered-usage-events

Individual Pro without Admin API: alert_check still works via cloud agent count + cache; spend/events show partial_errors until you add a team admin key.

Poll at most every 1–2 hours — Admin API aggregates hourly.


Env

Variable

Default

Purpose

CURSOR_API_KEY

—

User key, required

CURSOR_ADMIN_API_KEY

—

Team admin key, optional

CURSOR_MCP_HOST

127.0.0.1

HTTP bind

CURSOR_MCP_PORT

11000

HTTP port

CURSOR_INBOX_DIR

~/.cursor-mcp/inbox/

Message drop dir

CURSOR_HOURLY_SPEND_WARN_CENTS

300

~$3/h warn

CURSOR_ON_DEMAND_WARN_CENTS

2000

~$20 on-demand warn

CURSOR_RUNNING_AGENTS_WARN

3

Parallel agents warn

CURSOR_USAGE_EMAIL

—

Filter spend by email

Copy .env.example. Never commit real keys.


Fritz task

Scheduled coworker_cursor_spend_watch — every 2 hours, emails on warn or critical.

See docs/FRITZ_INTEGRATION.md.


MCPB (Claude Desktop)

uv sync
just mcpb-pack
# → dist/cursor-mcp-v0.2.0.mcpb — drag into Claude Desktop Extensions

Requires uv on PATH. Set CURSOR_API_KEY / CURSOR_ADMIN_API_KEY in the extension env.


Changelog

See CHANGELOG.md. Current: v0.2.0 (2026-06-07) — cursor_inbox + MCPB packaging.

Available Tools

6 tools
cursor_cloudA

List and inspect Cursor cloud agents (read-first; cancel is gated).

Runaway spend often correlates with many parallel cloud agents — list often.

Inputs: operation (required), agent_id, run_id, limit. Returns: object

cursor_docsB

Return fleet-curated Cursor documentation snippets.

Inputs: topic (required). Returns: object

cursor_helpA

List cursor-mcp tools and setup.

Inputs: no named parameters. Returns: object

cursor_inboxA

Inter-agent message drop for Cursor agents.

Any process writes a message to the shared inbox dir (CURSOR_INBOX_DIR). The Cursor agent calls cursor_inbox to poll, read, and acknowledge.

Typical flow:

  • Claude Desktop / meta_mcp / a script calls 'post' to leave a heads-up.

  • Cursor agent calls 'list' at task start to check for waiting messages.

  • Cursor agent calls 'read' for detail, then 'ack' when handled.

  • Periodic 'purge' to clean old acked messages.

No daemon, no network — pure filesystem. Default dir: ~/.cursor-mcp/inbox/ Override with CURSOR_INBOX_DIR env var.

Inputs: operation (required), sender, subject, body, +7 more. Returns: object

cursor_sdkA

Fleet-curated @cursor/sdk / cursor-sdk guidance (read-only, no agent spawn).

Jun 2026 SDK release: custom tools, auto-review, JSONL stores, nested subagents. Use before writing new headless automation — complements cursor_docs topics.

Inputs: operation (required). Returns: object

cursor_usageA

Cursor billing and spend guardrails (read-only).

Requires CURSOR_API_KEY. Admin endpoints also accept CURSOR_ADMIN_API_KEY (crsr_ team key). Use alert_check on a schedule (e.g. Fritz every 2h) instead of manual dashboard checks.

Inputs: operation (required), hours, email. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool targets a distinct domain: cloud agents, documentation, help, inter-agent inbox, SDK guidance, and billing. No overlap in purpose, clear boundaries.

    Naming Consistency5/5

    All tools follow a consistent 'cursor_<noun>' pattern with lowercase snake_case, making them easily predictable and grouped.

    Tool Count5/5

    Six tools is well-scoped for the server's purpose, covering key Cursor ecosystem areas without being too sparse or bloated.

    Completeness4/5

    Covers cloud agent inspection, documentation, help, inbox messaging, SDK guidance, and billing. Minor gap: cloud agent management lacks create/delete, but this is likely intentional.

    Maintenance

    ActivityActive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that instruments Cursor AI agent interactions with OpenTelemetry traces and logs to monitor agent turns and performance. It enables tracking of user queries, assistant responses, and tool usage through GenAI-compliant telemetry spans.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server that wraps Cursor Enterprise API to enable AI agents to answer questions about team spending, usage, and model adoption.
      17
      19 npm
      1
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A fast, hardened MCP server that lets any MCP host drive the Cursor Agent CLI for heavy repo-aware tasks like search, analysis, planning, and edits, keeping host context small and token costs low.
      10
      1
      MIT