Marketing MCP server

OpenPromo is a marketing MCP server: AI agents such as Claude, ChatGPT, Cursor, Codex and Gemini can read your brand profile, write post ideas, make images, carousels, reels and videos, and render them. Skills add ready-made marketing workflows on top. Setup takes a couple of minutes.

ChatGPT and Claude: sign in with OpenPromo

ChatGPT and Claude (on the web and in the desktop app) connect through a custom connector and sign in with your OpenPromo account. No API key needed.

1. Add a connector

   ChatGPT: Settings, Apps & Connectors, Advanced settings, turn on Developer mode, then Create. Claude: Settings, Connectors, Add custom connector.

2. Point it at OpenPromo

   Name it OpenPromo, set the server URL to https://api.openpromo.gg/mcp, and choose OAuth as the authentication. Leave the client ID and secret empty: the connector registers itself.

3. Sign in and allow

   A window opens on OpenPromo. Sign in if you need to, check what the connector will be able to do, and click Allow. You are sent back and the tools appear.

Connected apps are listed in Settings and usage in OpenPromo, where you can disconnect them at once. The connector never sees your password or keys. Developer mode and custom connectors depend on your ChatGPT or Claude plan.

Other agents: a setup prompt

1. Create an API key

   In the app, open Settings and usage and create an API key under API keys. It starts with opro_ and is shown once. Treat it like a password.

2. Put it in an environment variable

   # macOS and Linux: add to ~/.zshrc or ~/.bashrc
   export OPENPROMO_API_KEY="opro_..."
   
   # Windows (PowerShell), saved for new terminals
   setx OPENPROMO_API_KEY "opro_..."

   The prompt below never asks for the key in chat, so it stays out of your conversation history.

3. Paste the setup prompt into your agent

   Copy setup prompt

   The agent works out what it is, adds the OpenPromo server its own way, asks you to reload if needed, and checks the connection with two free calls. It does not create anything or spend during setup. The prompt in Settings in the app is already filled in with your install's address.

   Connect yourself to OpenPromo, an open-source promo media studio, over MCP. Work through these steps in order and stop at any step that needs me.
   
   1. Check first. Work out which agent you are (for example Claude Code, Claude Desktop, Cursor, VS Code, Codex, Gemini CLI, OpenCode or Windsurf) and whether an MCP server named "openpromo" is already set up. If it is and its tools work, go to step 5.
      If you are ChatGPT, or Claude on the web or in the desktop app, you cannot add servers yourself: tell me to add a custom connector in your settings with the URL https://api.openpromo.gg/mcp and OAuth sign-in, which needs no API key, then stop.
   
   2. The key. The connection needs an OpenPromo API key, which starts with opro_. Ask me to create one in the OpenPromo app under Settings, API keys, and to store it in an environment variable named OPENPROMO_API_KEY. Never ask me to paste the key into this chat, and never write it into a file inside a code repository.
   
   3. Add the server. Add a remote MCP server named "openpromo" with:
      - URL: https://api.openpromo.gg/mcp
      - Transport: streamable HTTP
      - Header: Authorization: Bearer <value of OPENPROMO_API_KEY>
      Use your own supported way of adding MCP servers, and read the key from the environment variable. If you cannot change your own configuration, tell me exactly what to add and where. Instructions for each agent: https://openpromo.gg/docs/mcp
   
   4. Reload. If the openpromo tools are not available yet, tell me how to restart or reload you, and stop.
   
   5. Verify, for free. Call whoami and list_projects. Both are free. During setup, do not run any paid generation, create projects or change settings.
   
   6. Report back in under 120 words: what you set up, whether whoami worked, the projects you found, and three things I could ask you next. Mention that paid generations show their price first, and that I can give you a spending limit for any request.

Claude marketing skills and plugin

Skills are written marketing workflows your agent follows, built on the MCP tools. Each one says the likely price before a paid step and asks before it renders.

In Claude Code, the plugin installs the MCP server and all the skills together. It reads your key from OPENPROMO_API_KEY and connects to https://api.openpromo.gg/mcp; set OPENPROMO_MCP_URL to use a self-hosted install instead.

/plugin install openpromo --marketplace duckduckdeploy/openpromo

# On older Claude Code versions, in two steps:
/plugin marketplace add duckduckdeploy/openpromo
/plugin install openpromo@openpromo

Then try /openpromo:promo-reel. For other agents, connect the server as below and add the skills with the skills command, or copy the folders from plugins/openpromo/skills in the repository into your agent's skills folder.

# Any agent that reads SKILL.md files (Claude Code, Codex, OpenCode and others)
npx skills add duckduckdeploy/openpromo/plugins/openpromo/skills

How you start a skill depends on the agent: a slash command in some, or just asking ("run the content-plan skill") in others.

Set it up by hand

Every client needs the same three things: the URL https://api.openpromo.gg/mcp, the streamable HTTP transport, and the header Authorization: Bearer followed by your key. Field names differ by client:

claude mcp add --transport http openpromo https://api.openpromo.gg/mcp \
  --header "Authorization: Bearer $OPENPROMO_API_KEY"

{
  "mcpServers": {
    "openpromo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.openpromo.gg/mcp",
               "--header", "Authorization:Bearer ${OPENPROMO_API_KEY}"],
      "env": { "OPENPROMO_API_KEY": "opro_..." }
    }
  }
}

{
  "mcpServers": {
    "openpromo": {
      "url": "https://api.openpromo.gg/mcp",
      "headers": { "Authorization": "Bearer ${env:OPENPROMO_API_KEY}" }
    }
  }
}

{
  "inputs": [
    { "type": "promptString", "id": "openpromo-key", "description": "OpenPromo API key", "password": true }
  ],
  "servers": {
    "openpromo": {
      "type": "http",
      "url": "https://api.openpromo.gg/mcp",
      "headers": { "Authorization": "Bearer ${input:openpromo-key}" }
    }
  }
}

[mcp_servers.openpromo]
url = "https://api.openpromo.gg/mcp"
bearer_token_env_var = "OPENPROMO_API_KEY"

{
  "mcpServers": {
    "openpromo": {
      "httpUrl": "https://api.openpromo.gg/mcp",
      "headers": { "Authorization": "Bearer $OPENPROMO_API_KEY" }
    }
  }
}

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "openpromo": {
      "type": "remote",
      "url": "https://api.openpromo.gg/mcp",
      "headers": { "Authorization": "Bearer {env:OPENPROMO_API_KEY}" }
    }
  }
}

{
  "mcpServers": {
    "openpromo": {
      "serverUrl": "https://api.openpromo.gg/mcp",
      "headers": { "Authorization": "Bearer ${env:OPENPROMO_API_KEY}" }
    }
  }
}

Self-hosting? Use your own API address, for example http://localhost:4100/mcp on your computer. See Self-hosting.

Check it works

Ask your agent to call whoami and list_projects. Both are free. If they work, the agent sees all 18 tools, listed with their prices in MCP tools.

Updating

/plugin marketplace update openpromo
/reload-plugins

For skills added with the skills command, run npx skills update. Copied folders: replace them with the latest from the repository. The MCP connection itself never needs updating: new tools appear on their own.

Troubleshooting

REST API

The same key works with the REST API, for scripts and your own tools. Send it in the same Authorization header.