Connect your coding agent

The MCP server is the executable showtake-mcp inside the app bundle. It speaks MCP over stdio, so every agent that can start a local MCP server can use it. The path is always:

/Applications/ShowTake.app/Contents/MacOS/showtake-mcp

Claude Code

claude mcp add --scope user showtake -- "/Applications/ShowTake.app/Contents/MacOS/showtake-mcp"

--scope user makes ShowTake available in every project. Check it with claude mcp list.

Codex

codex mcp add showtake -- "/Applications/ShowTake.app/Contents/MacOS/showtake-mcp"

Or add it to ~/.codex/config.toml yourself:

[mcp_servers.showtake]
command = "/Applications/ShowTake.app/Contents/MacOS/showtake-mcp"

Cursor

Add this to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "showtake": {
      "command": "/Applications/ShowTake.app/Contents/MacOS/showtake-mcp",
      "args": []
    }
  }
}

Gemini CLI

gemini mcp add --scope user showtake "/Applications/ShowTake.app/Contents/MacOS/showtake-mcp"

VS Code

Add this to .vscode/mcp.json in your project, or run MCP: Add Server from the command palette and choose a stdio server:

{
  "servers": {
    "showtake": {
      "type": "stdio",
      "command": "/Applications/ShowTake.app/Contents/MacOS/showtake-mcp"
    }
  }
}

Other clients

Any client that takes a command for a stdio MCP server works: give it the path above, no arguments, no environment variables.

The working directory matters

The server looks for Xcode projects in the working directory of the agent (list_targets). Start your agent in the folder of the app you want to film, or pass project to prepare_ios.

What the agent gets

• Tools to prepare, drive and film the app (tool reference).
• The agent guide as the MCP resource showtake://guide and the prompt film_demo. Most agents read it on their own; if yours does not, tell it "read the ShowTake guide first".