Dyslexia StepsDeveloper docs
Docs / MCP server / Connect VS Code

Connect VS Code

Updated 2026-10-18

The workspace file is .vscode/mcp.json. Its top-level key is servers, not mcpServers.

Steps

  1. Create .vscode/mcp.json in the project root and paste one of the blocks below. The MCP: Add Server command in the Command Palette walks through the same setup.
  2. Start the server with the Start link that appears above it in the file. The tools show up in Copilot Chat's Agent mode.
  3. To add the local server to your user profile instead of one workspace, use the command-line form.

Configuration

Hosted (recommended)
{
  "servers": {
    "dyslexiasteps": {
      "type": "http",
      "url": "https://mcp.dyslexiasteps.com/mcp"
    }
  }
}
Local (npx)
{
  "servers": {
    "dyslexiasteps": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "dyslexiasteps-mcp"]
    }
  }
}
User profile (local)
code --add-mcp "{\"name\":\"dyslexiasteps\",\"command\":\"npx\",\"args\":[\"-y\",\"dyslexiasteps-mcp\"]}"

Check it works

Ask: “Using Dyslexia Steps, how many English word lists cover kindergarten?” The answer should be 23.

Source for the VS Code syntax: VS Code: MCP servers. Client menus and file locations change; if a step no longer matches, follow that page and tell us on GitHub.

See also the tool reference and troubleshooting.