Browse the user guide

VS Code with GitHub Copilot

Add Shotomatic to VS Code with GitHub Copilot as a local MCP server, check that it works, and fix common setup problems.

Updated November 16, 2026

View Markdown
On this page

VS Code with GitHub Copilot can use Shotomatic through Shotomatic's local MCP server. These steps follow VS Code with GitHub Copilot's own documentation (MCP configuration reference and Manage MCP servers); Shotomatic is tested with Claude Code and Codex, not with VS Code with GitHub Copilot. If a menu or file no longer matches, check VS Code with GitHub Copilot's docs.

Before you start

  • In Shotomatic, open Settings > AI agents and turn on Let AI agents use Shotomatic.
  • Install Node 18.3 or later. The client starts a small bridge package named shotomatic with npx; there is no API key.
  • On a Mac, grant Screen Recording and, for key presses, Accessibility. See macOS permissions.

Add Shotomatic to VS Code with GitHub Copilot

VS Code uses servers, not mcpServers, and requires type. Add this to .vscode/mcp.json in a workspace:

{
  "servers": {
    "shotomatic": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "shotomatic", "mcp"]
    }
  }
}

To add it to your user profile instead, run:

code --add-mcp '{"name":"shotomatic","type":"stdio","command":"npx","args":["-y","shotomatic","mcp"]}'

VS Code may ask you to trust the server the first time it starts.

On Windows, if the client cannot start npx, use cmd as the command and /c, npx, -y, shotomatic, mcp as the arguments.

Approve it once

The first time VS Code with GitHub Copilot connects, Shotomatic shows an approval card with the name VS Code with GitHub Copilot reports for itself. Select Allow. Until you do, the agent can only read Shotomatic's status. See Approvals and confirmations.

Check that it works

Run MCP: List Servers from the Command Palette to see the server and start or restart it. Then ask:

"Check Shotomatic's status and tell me what you can do with it."

A working setup answers with the Shotomatic version, whether Screen Recording and Accessibility are granted on a Mac, your plan and the free screenshots left today, whether the website browser is installed, and any capture already running.

Shotomatic returns previews as images inside tool results. VS Code with GitHub Copilot's docs do not say whether those images reach the model, so the agent may receive only text for them.

If the tool is unavailable

  • The server is ignored. Check that the entry sits under servers and has "type": "stdio".
  • "MCP access is turned off." Turn on Let AI agents use Shotomatic in Settings > AI agents, then restart the client.
  • No approval card appears. Open Shotomatic and look for the card; on a Mac, its Dock icon bounces when the card appears.
  • The client cannot find npx or Node. See the troubleshooting list for all clients.

Next, try a request from What agents can do, or see every tool in the Tools reference.

VS Code with GitHub Copilot | User Guide | Shotomatic