Use Planegraph's MCP server

Connect your AI apps to Planegraph with the Model Context Protocol (MCP), an open standard that lets AI assistants use other services' tools. Your assistant can then search real ads, remake them for your brand, make UGC videos and generate images and video in your Planegraph account.

Quick setup

Use the add-mcp CLI to add Planegraph to every coding agent on your computer.

npx -y add-mcp https://mcp.planegraph.com/mcp --name planegraph -g

Claude, Cursor and VS Code also install in one click. For ChatGPT and the other apps, follow the steps in Setup.

What is Planegraph MCP?

Planegraph MCP is Planegraph's official MCP server. It's a remote MCP server with OAuth that gives AI apps access to your Planegraph account, at:

https://mcp.planegraph.com/mcp

It works with AI assistants such as Claude and ChatGPT, so you can:

• Search about 4,400 real Meta ads by brand, product or category
• Remake a library ad for your brand with Ad Remix
• Make UGC videos with realistic AI avatars
• Generate images and videos with Nano Banana 2, GPT Image 2, Seedance 2.5, Veo 3.1 Fast and other models
• Upload product photos and logos from your device

Planegraph MCP implements the MCP Authorization and Streamable HTTP specifications, plus MCP Apps for results inside the chat.

Available tools

The assistant can use 11 tools. The in-chat viewer uses two more to show a job's progress and keep the upload box open.

Results in the chat

Apps that support MCP Apps, such as Claude and ChatGPT, show Planegraph's results inside the conversation:

• Ad and avatar grids, with buttons to remake an ad or make a video with an avatar
• A job’s progress, then its images, video or remake
• An upload box for photos from your device

Other apps show the same results as text and links.

Credits

Planegraph MCP uses the credits on your Planegraph plan.

• An Ad Remix costs 50 credits.
• A UGC video costs 200 credits.
• An image or video costs the model’s price, the same as in the Planegraph app.
• Browsing the ad library and avatars costs nothing.
• Planegraph refunds anything that fails, down to a single image in a set.
• Planegraph asks the assistant to check with you before any image or video that costs more than about 200 credits.

Supported apps

Planegraph's sign-in works with these apps:

• Claude and Claude for desktop
• ChatGPT
• Grok
• Claude Code
• Codex CLI
• Cursor
• VS Code with Copilot
• Windsurf
• Devin
• Raycast
• Goose
• Gemini CLI
• Gemini Code Assist
• OpenCode
• Pi

The add-mcp command in Quick setup also configures other apps that support remote MCP servers.

Setup

Add Planegraph to your app. The first time it connects, sign in to Planegraph and approve the app.

Claude and Claude for desktop

Claude connects to Planegraph on claude.ai, in Claude for desktop and in the iOS and Android apps. Free plans can add one custom connector.

1. Open Customize, then Connectors.
2. Select Add custom connector.
3. Enter the name Planegraph and the URL https://mcp.planegraph.com/mcp, then select Add.
4. Select Connect and sign in to Planegraph.

An Owner adds the connector for a Team or Enterprise plan under Organization settings, then Connectors. Connectors you add on claude.ai also appear in the mobile apps.

Claude's guide to custom connectors has more detail.

ChatGPT

ChatGPT connects to Planegraph in developer mode on the web. Business, Enterprise and Edu workspaces can use every tool. OpenAI limits other plans to read-only tools, such as the ad library and avatars.

1. Turn on Developer mode in ChatGPT's settings.
2. Open Plugins, select the plus button and choose Add custom MCP server.
3. Enter the name Planegraph and the URL https://mcp.planegraph.com/mcp, and choose OAuth for authentication.
4. Select Create, then sign in to Planegraph.

Business and Enterprise admins add the server under Workspace settings, then Apps.

OpenAI's guide to developer mode has more detail.

Grok

1. Open grok.com/connectors.
2. Select New Connector, then Custom.
3. Enter the URL https://mcp.planegraph.com/mcp and sign in to Planegraph.

xAI's guide to connectors has more detail.

Claude Code

claude mcp add --transport http planegraph --scope user https://mcp.planegraph.com/mcp

Then run /mcp in Claude Code, select planegraph and sign in to Planegraph.

Claude Code's MCP guide has more detail.

Codex CLI

Codex signs in with a separate command, so run both.

codex mcp add planegraph --url https://mcp.planegraph.com/mcp
codex mcp login planegraph

Codex's MCP guide has more detail.

Cursor

The button adds Planegraph to Cursor. You can also add the snippet to ~/.cursor/mcp.json for every project, or to .cursor/mcp.json for one.

{
  "mcpServers": {
    "planegraph": {
      "url": "https://mcp.planegraph.com/mcp"
    }
  }
}

Cursor then shows Needs login beside Planegraph. Select it to sign in.

Cursor's MCP guide has more detail.

VS Code with Copilot

The button adds Planegraph to VS Code. You can also add the snippet to your mcp.json.

{
  "servers": {
    "planegraph": {
      "type": "http",
      "url": "https://mcp.planegraph.com/mcp"
    }
  }
}

1. Open the Command Palette and run MCP: List Servers.
2. Select planegraph, then Start Server.
3. Allow the sign-in when VS Code asks, then sign in to Planegraph.

Copilot Business and Enterprise admins turn on the MCP servers in Copilot policy first.

VS Code's MCP guide has more detail.

Windsurf

Windsurf is now Devin Desktop. Add the snippet to ~/.config/devin/mcp_config.json, or to ~/.codeium/windsurf/mcp_config.json in older versions. Cascade supports OAuth for remote servers, so it asks you to sign in to Planegraph when it connects.

{
  "mcpServers": {
    "planegraph": {
      "serverUrl": "https://mcp.planegraph.com/mcp"
    }
  }
}

Enterprise users turn on MCP in Windsurf's settings first.

Windsurf's MCP guide has more detail.

Devin

1. Open Customize, then MCPs, and select Add MCP, then Add custom MCP.
2. Enter the name Planegraph, choose the HTTP transport and enter the URL https://mcp.planegraph.com/mcp.
3. Choose OAuth as the authentication method, then select Save.
4. Select Connect under Customize, then MCPs, and sign in to Planegraph.

Adding a server needs the Manage MCP Servers permission. These steps cover Devin on app.devin.ai.

Devin's MCP guide has more detail.

Raycast

MCP servers are a Raycast Pro feature.

1. Run the Install MCP Server command.
2. Enter the name Planegraph, choose the HTTP transport, enter the URL https://mcp.planegraph.com/mcp and choose the Dynamic OAuth type.
3. Press ⌘↵ to install, then select Sign In.

Raycast's MCP guide has more detail.

Goose

The button adds Planegraph to Goose. The Goose CLI adds it with goose configure: choose Add Extension, then Remote Extension (Streamable HTTP), and enter the URL. Goose opens the Planegraph sign-in when the extension connects.

Goose's extensions guide has more detail.

Gemini CLI

gemini mcp add --transport http --scope user planegraph https://mcp.planegraph.com/mcp

You can also add the snippet to ~/.gemini/settings.json. Use httpUrl, since url means the older SSE transport.

{
  "mcpServers": {
    "planegraph": {
      "httpUrl": "https://mcp.planegraph.com/mcp"
    }
  }
}

Then run /mcp auth planegraph in Gemini CLI and sign in to Planegraph.

Gemini CLI's MCP guide has more detail.

Gemini Code Assist

Agent mode in VS Code reads the same ~/.gemini/settings.json as Gemini CLI. IntelliJ connects to Planegraph through mcp-remote in your mcp.json.

{
  "mcpServers": {
    "planegraph": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.planegraph.com/mcp"
      ]
    }
  }
}

Restart your IDE, then sign in to Planegraph when it asks.

Gemini Code Assist's agent guide has more detail.

OpenCode

Add the snippet to opencode.json in your project, or to ~/.config/opencode/opencode.json.

{
  "mcp": {
    "planegraph": {
      "type": "remote",
      "url": "https://mcp.planegraph.com/mcp",
      "enabled": true
    }
  }
}

OpenCode starts the sign-in when it first connects. You can also run opencode mcp auth planegraph.

OpenCode's MCP guide has more detail.

Pi

pi mcp add planegraph --url https://mcp.planegraph.com/mcp
pi mcp login planegraph

You can also add the snippet to ~/.pi/agent/mcp.json, then run /mcp login planegraph in Pi.

{
  "mcpServers": {
    "planegraph": {
      "url": "https://mcp.planegraph.com/mcp"
    }
  }
}

Pi's MCP guide has more detail.

Setup steps can change as each app updates. Each app's own guide has its latest steps.

Security best practices

• Use the official URL. Connect only to https://mcp.planegraph.com/mcp. Check the address before you approve a one-click install from another site.
• Approve each app. Planegraph shows a consent screen with the app's name before any app can use your account.
• Watch your credits. A connected app can spend your credits. Keep your app's confirmations on for tools that cost credits.
• Watch for prompt injection. Text in a web page or another server's results can try to steer the assistant. Review what the assistant asks to run.
• Disconnect apps you no longer use. Remove Planegraph from the app's connector settings.

Questions