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