Cursor MCP

Configure MCP servers on Cursor SDK agents — stdio subprocess, HTTP, and SSE transports, inline vs file-based config, and per-run overrides. Use when extending an agent's tools beyond the built-ins.

HKTITAN ccadf04 9 files · 5.6 KB Updated

File contents

cursor-mcp

MCP servers expose tools to the agent. Configure them on AgentOptions.mcpServers (or SendOptions.mcpServers for per-run override) as Record<string, McpServerConfig> — the key is the server name.

Transports

  • [[references/stdio]] — command, args, env, cwd
  • [[references/http]] — url, headers, auth
  • [[references/sse]] — url with SSE transport

Configuration patterns

  • [[references/inline-config]] — mcpServers on Agent.create
  • [[references/per-run-override]] — mcpServers on agent.send (replaces, doesn't merge)
  • [[references/file-config]] — .cursor/mcp.json and settingSources
  • [[references/persistence]] — inline servers are not persisted across Agent.resume

Auth

  • [[references/oauth]] — auth.CLIENT_ID / CLIENT_SECRET / scopes for HTTP/SSE

Cross-links

  • Tool calls in the stream → [[../cursor-runs/references/sdk-message-types]]
  • Subagent-scoped MCP → [[../cursor-subagents/references/agent-definition]]
  • Hooks for tool gating → [[../cursor-hooks/SKILL]]
  • IntegrationNotConnectedError → [[../cursor-errors/references/integration-not-connected]]

HKTITAN/cursor-sdk/tree/main/skills/cursor-mcp commit ccadf04a8c

Frequently asked questions

npx skillmds@latest add hktitan/cursor-mcp