A meme MCP server for AI video agents

Connect from Claude or ChatGPT

Clients that support MCP sign-in (OAuth) need only the URL, https://api.greenscreenmemes.app/mcp: you sign in with your Green Screen Memes API account (Google or an email link) and allow the app, instead of pasting a key. An account without a key gets one when it first connects.

Claude

On claude.ai or in the Claude apps, open Customize, then Connectors, and choose Add custom connector. Enter the URL https://api.greenscreenmemes.app/mcp, then click Connect and sign in. On Team and Enterprise plans an owner may need to add it for the organization first.

ChatGPT

At chatgpt.com/plugins (custom MCP servers need developer mode, and your workspace may need to allow them), choose the plus button, then Add custom MCP server. Enter the URL https://api.greenscreenmemes.app/mcp, choose OAuth for authentication, and sign in when ChatGPT asks.

Claude Code, with sign-in

claude mcp add --transport http green-screen-memes https://api.greenscreenmemes.app/mcp
# then, in Claude Code: /mcp, pick green-screen-memes, Authenticate

The app works on your account's key and plan, and what it does counts toward your plan like any other call. See and disconnect connected apps on the dashboard under Profile. Rolling your key disconnects them all.

Connect with an API key

Put your key in an environment variable first (export GSM_API_KEY=gsm_live_...), so it stays out of config files you commit.

Claude Code

claude mcp add --transport http green-screen-memes https://api.greenscreenmemes.app/mcp \
  --header "Authorization: Bearer $GSM_API_KEY"

Or commit a .mcp.json to your project root. Claude Code fills in ${GSM_API_KEY} from your environment.

{
  "mcpServers": {
    "green-screen-memes": {
      "type": "http",
      "url": "https://api.greenscreenmemes.app/mcp",
      "headers": {
        "Authorization": "Bearer ${GSM_API_KEY}"
      }
    }
  }
}

Cursor

Add this to .cursor/mcp.json in your project, or to ~/.cursor/mcp.json for every project. Cursor reads the key with ${env:GSM_API_KEY}.

{
  "mcpServers": {
    "green-screen-memes": {
      "url": "https://api.greenscreenmemes.app/mcp",
      "headers": {
        "Authorization": "Bearer ${env:GSM_API_KEY}"
      }
    }
  }
}

Claude Desktop

Claude Desktop runs local servers, so bridge it with mcp-remote (needs Node). Add this to claude_desktop_config.json (Settings, then Developer, then Edit Config), put your key in AUTH_HEADER, and restart the app.

{
  "mcpServers": {
    "green-screen-memes": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.greenscreenmemes.app/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer gsm_live_your_key_here"
      }
    }
  }
}

Other clients

Any client that speaks Streamable HTTP: URL https://api.greenscreenmemes.app/mcp, header Authorization: Bearer <your key>, or no header if it supports MCP OAuth (it finds the sign-in at /.well-known/oauth-protected-resource/mcp). Agent frameworks without MCP can call the same things over REST.

Look before you sign up

This works without a key and returns all the tools with their input schemas:

curl -s https://api.greenscreenmemes.app/mcp \
  -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

The 7 tools

All of them are read-only and safe to call repeatedly. Each tool call counts as one API call.

The server's instructions tell the agent to search by feeling or action ("shocked", "slow clap", "happy dance") rather than by meme name, to pick a match by its name, description and tags, to call get_green_screen for the link and recipe, and to follow the terms.

What an agent does with it

A run in Claude Code, shortened. The search results are real.

search_green_screens({ "query": "side eye", "limit": 3 })

get_green_screen({ "id": "Dog giving awkward side eye" })

{
  "name": "Dog giving awkward side eye",
  "chromaKeyColor": "green",
  "durationSeconds": 6,
  "videoUrl": "https://api.greenscreenmemes.app/v1/media/m/Dog%20giving%20awkward%20side%20eye/video?k=…",
  "howToComposite": {
    "download": "curl -L -o greenscreen.mp4 \"…\"",
    "keyColor": "0x00ff00",
    "overImage": "ffmpeg -loop 1 -i background.jpg -i greenscreen.mp4 -filter_complex …",
    "notes": ["…", "For a caption, add ,drawtext=… after format=yuv420p", "…"]
  }
}

Limits and pricing

• initialize, tools/list and ping are free and work without a key.
• Each tools/call is one API call; each video download is one download. get_usage shows where your key stands.
• Plans: Sandbox (free), 50 downloads and 30k calls; Starter $49/month, 2k downloads and 100k calls; Growth $199/month, 20k downloads and 1M calls; Enterprise from $999/month, 200k downloads and 10M calls. See pricing.
• Links in results are signed and expire after about 6 hours; call the tool again for fresh ones.

What you can use the clips for

These are internet memes: Green Screen Memes makes the green screen versions, but the original footage isn't ours and isn't licensed with the clips, so how you use one is up to you. On Starter and up you can publish videos with them, for yourself or clients. Don't put clips of identifiable people in paid ads, sponsored posts or endorsements; animals, objects and cartoons are fine there. The terms have the details. Sandbox keys are for building and testing.

Questions