Claude, Cursor & Copilot

Every MCP-compatible agent can drive Heretic Lazy Shot. Below are copy-paste configs for the four most common clients.

Prerequisites

1. Heretic Lazy Shot is installed and running
2. MCP server is enabled under Settings → MCP
3. Note your session token — Settings → MCP → Copy token

Claude Desktop

Edit the Claude config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "heretic-lazy-shot": {
      "command": "lazy-shot-mcp",
      "args": ["--stdio"],
      "env": {
        "LAZY_SHOT_TOKEN": "paste-your-token-here"
      }
    }
  }
}

Restart Claude Desktop. The 🔌 icon should show heretic-lazy-shot connected.

Claude Code

In your project, add an MCP server via the CLI:

claude mcp add heretic-lazy-shot lazy-shot-mcp --stdio

Or edit ~/.config/claude/mcp.json manually with the same shape as Claude Desktop.

Cursor

Open Settings → Features → MCP. Click + Add new MCP server.

• Name: heretic-lazy-shot
• Type: stdio
• Command: lazy-shot-mcp --stdio
• Env: LAZY_SHOT_TOKEN=your-token

Restart Cursor. Open the composer panel and type @heretic-lazy-shot to verify tool discovery.

GitHub Copilot (CLI)

gh copilot extension install heretic/lazy-shot
export LAZY_SHOT_TOKEN=your-token

Then from any Copilot chat prompt:

@lazy-shot capture the active terminal window and export as png

Generic MCP client (HTTP)

If your client supports HTTP transport:

{
  "type": "http",
  "url": "http://127.0.0.1:4717/mcp",
  "headers": {
    "Authorization": "Bearer your-token"
  }
}

Verification prompts

Once connected, paste any of these to verify:

List the MCP tools available from heretic-lazy-shot.

Capture the active window, apply the twitter-16-9 preset,
add a soft drop shadow, and open the result.

Take 3 screenshots of my Chrome window, each spaced 5 seconds apart,
with filenames run-1, run-2, run-3.

Troubleshooting

See MCP tools for the full reference.