Connect your agent
Add the server URL to mcp_config.json.
Open ScreenTap
The MCP server runs while the ScreenTap app is open.
Open the MCP config
In Windsurf, open Settings › Cascade › MCP Servers and choose View raw config. This opens ~/.codeium/windsurf/mcp_config.json.
Add ScreenTap
Paste this in. If the file already has servers, add only the "screentap" entry. Note that Windsurf calls the field serverUrl.
{
"mcpServers": {
"screentap": { "serverUrl": "http://127.0.0.1:47811/mcp" }
}
}Refresh and try it
Refresh the MCP servers in Cascade, then ask:
Take a screenshot of my iPhone and tell me what's on screen.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.