Cursor
Add Shotomatic to Cursor as a local MCP server, check that it works, and fix common setup problems.
Updated November 16, 2026
On this page
Cursor can use Shotomatic through Shotomatic's local MCP server. These steps follow Cursor's own documentation (Model Context Protocol in Cursor); Shotomatic is tested with Claude Code and Codex, not with Cursor. If a menu or file no longer matches, check Cursor'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
shotomaticwithnpx; there is no API key. - On a Mac, grant Screen Recording and, for key presses, Accessibility. See macOS permissions.
Add Shotomatic to Cursor
Add this to ~/.cursor/mcp.json for every project, or to .cursor/mcp.json inside one project:
{
"mcpServers": {
"shotomatic": {
"type": "stdio",
"command": "npx",
"args": ["-y", "shotomatic", "mcp"]
}
}
}
Cursor asks for approval before using MCP tools by default.
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 Cursor connects, Shotomatic shows an approval card with the name Cursor reports for itself. Select Allow. Until you do, the agent can only read Shotomatic's status. See Approvals and confirmations.
Check that it works
Check that the server is enabled in Customize. 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.
Cursor's docs say it supports images in MCP tool results, so the agent can see previews and frames it asks for.
If the tool is unavailable
- The server shows an error. Cursor shows start-up errors in Output (
Cmd + Shift + U, orCtrl + Shift + Uon Windows) under MCP Logs. - "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
npxor 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.