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.
Source facts
- Repository
- HKTITAN/cursor-sdk
- Last source activity
- May 3, 2026 at 08:23
- Detected SKILL.md language
- English
- Stars
- 2
- Forks
- 0
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
File Explorer
9 filesShowing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- cursor-mcp
- description
- 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.
- metadata
- {"internal":false,"source":"https://cursor.com/docs/sdk/typescript"}
# 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]]
View on GitHub