---
title: MCP servers
description: Author MCP config once; sks translates it for every agent's format.
status: draft
sidebar:
  order: 4
---

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:

```json
{
  "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:

```sh
sks import-mcp my-skillset
```