Cursor — MCP Configs
- File format
- JSON
- Discovery path
-
.cursor/mcp.json - Syllago install method
- JSON merge
- Symlink support
- No
- Config file
-
.cursor/mcp.json - Transports
-
stdio,sse,streamable-http
Features
How each feature converts to syllago's canonical format. See format conversion for what these statuses mean.
Fields
Native frontmatter or config fields this provider exposes. The first column is the provider's own field name; the canonical key column links to syllago's cross-provider equivalent.
| Config key | Conversion | Canonical key | Summary |
|---|---|---|---|
type | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | — | Supports stdio, sse, and streamable-http transports chosen by the server configuration. |
env | Preserved Conversion type: Preserved Syntax survives conversion but the target provider may not interpret it. Learn more → | — | Per-server env maps pass environment variables (including secrets sourced from the user's shell) to stdio servers. |
Other features
Behaviors, conventions, and capabilities that aren't tied to a single named field — things like path-based activation, discovery rules, and lifecycle behavior.
| Feature | Conversion | Summary |
|---|---|---|
env_var_expansion | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | Server env blocks reference environment variables so secrets can be read from the shell environment rather than hardcoded. |
marketplace | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | Cursor ships an in-IDE MCP directory for discovering and installing community MCP servers. |
| Project and global MCP config files | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | Project-scope servers live in .cursor/mcp.json at the repo root; user-global servers live in ~/.cursor/mcp.json. |
transport_types | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | Cursor documents three MCP transports: stdio for local processes, sse for Server-Sent Events, and streamable-http for HTTP-based remote servers. |
| In-IDE MCP directory | Not portable Conversion type: Not portable Unique to this provider — can’t be carried across providers. Learn more → | Cursor exposes an MCP directory inside the IDE for browsing and installing community MCP servers without editing mcp.json by hand. |
Sources
| Source |
|---|
| https://cursor.com/docs/mcp |