# 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.

- Skill: `hktitan/cursor-mcp` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add hktitan/cursor-mcp`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hktitan/cursor-mcp/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: HKTITAN (https://skillmd.com/u/hktitan)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hktitan/cursor-mcp

---


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