Quick start

Wire zshot into your agent and move on. Each app launches zshot as a local MCP server over stdio — it runs zshot --mcp-local-server as a subprocess and talks to it over stdin and stdout. See Agents for how the transports differ and MCP for running zshot as an HTTP server instead.

The bundled Agent Skill teaches the agent what zshot does and how to call it. Install it into the directory each app loads skills from, shown below. LM Studio loads no skills and relies on the MCP server’s own tool descriptions.

Claude Code

claude mcp add --transport stdio -- zshot --mcp-local-server
mkdir -p ~/.claude/skills && zshot --install-skill ~/.claude/skills/

Claude Code MCP docs.

Claude Desktop

Add zshot to claude_desktop_config.json, then restart Claude Desktop:

{
  "mcpServers": {
    "zshot": {
      "command": "zshot",
      "args": ["--mcp-local-server"]
    }
  }
}

The file lives at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS. Build a skill bundle to import from Settings with zshot --install-skill ./zshot.zip.

Claude Desktop MCP docs.

Cursor

Add zshot to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "zshot": {
      "command": "zshot",
      "args": ["--mcp-local-server"]
    }
  }
}

Install the skill where Cursor loads them:

mkdir -p ~/.cursor/skills && zshot --install-skill ~/.cursor/skills/

Cursor MCP docs · skills.

VS Code

Add zshot to VS Code’s mcp.json (note the top-level servers key, not mcpServers):

{
  "servers": {
    "zshot": {
      "type": "stdio",
      "command": "zshot",
      "args": ["--mcp-local-server"]
    }
  }
}

The file lives at ~/Library/Application Support/Code/User/mcp.json on macOS (~/.config/Code/User/mcp.json on Linux). Copilot’s agent mode loads MCP servers directly — no skill needed.

VS Code MCP docs.

OpenCode

Add zshot to the mcp block of opencode.json:

{
  "mcp": {
    "zshot": {
      "type": "local",
      "command": ["zshot", "--mcp-local-server"],
      "enabled": true
    }
  }
}

Install the skill where OpenCode loads them:

mkdir -p ~/.agents/skills && zshot --install-skill ~/.agents/skills/

OpenCode MCP docs · skills.

OpenAI Codex CLI

Add the server in one command:

codex mcp add zshot -- zshot --mcp-local-server

Or write the equivalent block to ~/.codex/config.toml:

[mcp_servers.zshot]
command = "zshot"
args = ["--mcp-local-server"]

Install the skill where Codex loads them:

mkdir -p ~/.agents/skills && zshot --install-skill ~/.agents/skills/

Codex MCP docs · skills.

LM Studio

Add zshot to LM Studio’s mcp.json:

{
  "mcpServers": {
    "zshot": {
      "command": "zshot",
      "args": ["--mcp-local-server"]
    }
  }
}

LM Studio MCP docs.