ScreenTapDocs
PricingSupportBack to site

Getting started

  • How it works
  • Installation
  • First-time setup

Connect your agent

  • Overview
  • Claude Code
  • Claude Desktop
  • Cursor
  • Codex
  • Windsurf
  • VS Code
  • Gemini CLI
  • Other clients

Using ScreenTap

  • Giving tasks
  • Tools

Account

  • License & billing
  • Privacy

Help

  • Troubleshooting
Docs / Cursor⌄

Getting started

  • How it works
  • Installation
  • First-time setup

Connect your agent

  • Overview
  • Claude Code
  • Claude Desktop
  • Cursor
  • Codex
  • Windsurf
  • VS Code
  • Gemini CLI
  • Other clients

Using ScreenTap

  • Giving tasks
  • Tools

Account

  • License & billing
  • Privacy

Help

  • Troubleshooting
← PreviousClaude DesktopNext →Codex

Connect your agent

Set up Cursor

Add the server URL to mcp.json.

  1. 1

    Open ScreenTap

    The MCP server runs while the ScreenTap app is open.

  2. 2

    Add ScreenTap to mcp.json

    For all projects, edit ~/.cursor/mcp.json. For one project, use .cursor/mcp.json in that project. If the file already has servers, add only the "screentap" entry.

    mcp.json
    {
      "mcpServers": {
        "screentap": { "url": "http://127.0.0.1:47811/mcp" }
      }
    }
  3. 3

    Check it's connected

    Open Cursor Settings and find the MCP section. ScreenTap should show a green dot and its list of tools.

  4. 4

    Try it

    Open the chat in Agent mode and ask:

    Prompt
    Take a screenshot of my iPhone and tell me what's on screen.

Good to know

  • Cursor asks before running each tool. You can allow ScreenTap's tools to run automatically in Cursor's settings.

Not working?

Check that the ScreenTap app is open and your iPhone is connected, then restart your agent or start a new session. More fixes in Troubleshooting.