Skip to content

MCP servers

Agents disagree about where MCP config lives — .mcp.json, Codex’s config.toml, Gemini/VS Code/Zed settings.json, Cursor’s mcp.json. Skillsets makes you author it once.

Each server is one canonical file in the skillset’s mcp/ directory:

{
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": { "GITHUB_TOKEN": "${env:GITHUB_TOKEN}" }
}

On switch, sks emits the right format for each configured agent. ${env:VAR} placeholders are rewritten per agent’s convention, and the variables land in the skillset’s requiredEnv so users know what to set.

Already have MCP servers configured on disk? Pull them into a skillset:

Terminal window
sks import-mcp my-skillset

this page as markdown: /skillsets/guides/mcp.md· index for agents: /llms.txt