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]]