Documentation
MCP (AI Agents)
Set Up with Cursor

Set Up with Cursor

Cursor is an AI-powered IDE that supports MCP servers natively. Once connected, Cursor’s agent can control ButterKit directly from your editor.

A few examples of what you can do:

  • Localize screenshots in one command. Add languages, translate every artboard and App Store metadata field, then export, all in seconds.
  • Design and iterate from a prompt. Describe the layout you want, swap copy, adjust 3D devices, and preview renders without switching windows.
  • Upload straight to App Store Connect. Push finished screenshots and metadata to your store listing as soon as they’re ready.
  • Wire it into your build process. Pair Cursor AI agents + Fastlane with ButterKit to capture new Simulator screenshots, design around them, translate, and publish in a single session.

2 minute video tutorial

Prerequisites

  • ButterKit running with MCP enabled (Settings > MCP)
  • Cursor installed

Configuration

Open MCP settings

In Cursor, open Settings > MCP (or edit your .cursor/mcp.json file directly).

Add the ButterKit server

Add the following to your MCP configuration:

{
  "mcpServers": {
    "butterkit": {
      "command": "/Applications/ButterKit.app/Contents/MacOS/butterkit-mcp"
    }
  }
}

Optional: auto-launch ButterKit. If you’d like ButterKit to start automatically when Cursor connects, add "args": ["--auto-launch"] to the config above. See Auto-Launch for details.

Verify the connection

Restart Cursor or reload the MCP servers. You should see butterkit listed as a connected server with 40 available tools.

Start using it

Ask Cursor’s agent to interact with ButterKit. For example:

  • “List my open ButterKit documents”
  • “Create three iPhone artboards and apply a template”
  • “Translate all artboards into Spanish and Japanese”

Tips

  • Cursor’s agent will automatically discover ButterKit’s tools and call them as needed.
  • You can combine ButterKit MCP calls with file edits, terminal commands, and other MCP servers in a single conversation.
  • For a walkthrough of common multi-step tasks, see Workflows.

Quick Help

Set Up with Claude