DocsReference
OpenPromo MCP tools
Every tool of the OpenPromo MCP server: account, projects and brand, ideas, creations, renders and the library, with what each one does and costs.
The OpenPromo MCP server at https://api.openpromo.gg/mcp has 18 tools. Each one is a thin wrapper over the REST API, called with your own key, so agents get the same checks, prices and spending limit as the app. To connect, see Marketing MCP server.
Most tools take an optional project_id. When the account has exactly one project, it can be left out.
Account
| Tool | What it does | Cost |
|---|---|---|
| whoami | The signed-in user and whether a YepAPI key is connected. | Free |
| get_balance | Remaining YepAPI balance, and this month’s spend and limit. | Free |
| get_usage | This month’s spend by feature and by day, with the 10 latest calls. | Free |
Projects and brand
| Tool | What it does | Cost |
|---|---|---|
| list_projects | Your projects, one per website, and whether each brand profile is ready. | Free |
| create_project | Add a website as a project. The site is read in the background (about a minute); poll get_brand until it is ready. | About $0.10 |
| get_brand | The brand profile: identity, audience, selling points with their sources, voice, colors, fonts, products and flows. | Free |
| update_brand | Replace the brand profile with an edited copy. Edited fields are kept when the site is read again. | Free |
| refresh_brand | Read the website again and rebuild the profile; hand edits are kept unless reset is true. | About $0.10 |
| update_project_context | Replace the project’s shared notes for agents: campaigns, goals, things to avoid. | Free |
Ideas
| Tool | What it does | Cost |
|---|---|---|
| list_ideas | Saved post ideas, newest first, with hook, caption and hashtags. | Free |
| generate_ideas | Write new post ideas from the brand profile, by goal, channel and type, each with the selling points it uses. | About $0.02 – $0.06 |
Creations and renders
| Tool | What it does | Cost |
|---|---|---|
| list_creations | Images, carousels, reels, promo videos and tutorials, with status and latest render. | Free |
| create_creation | Write a new image, carousel, reel, promo video or tutorial from an idea or a brief. Returns scenes and checks; nothing is rendered yet. | About $0.03 – $0.08 |
| get_creation | A creation’s scenes, post caption, checks and renders. | Free |
| update_creation | Save edits to a creation: its scenes, style, audio and captions, title or post caption. The checks run again. | Free |
| render_creation | Render a creation to files in the background, at its own size or another one; poll get_render. | Images $0 unless AI pictures are used ($0.04 – $0.20 each). Videos: voice about $0.01 a scene, music $0.08, AI clips about $0.11 a second |
| get_render | A render’s status and progress, and when done its output, thumbnail and caption file ids. | Free |
Library
| Tool | What it does | Cost |
|---|---|---|
| list_assets | Files in the library: screenshots, logo, product photos, uploads, AI pictures, voice, music and finished media. | Free |
A typical flow
list_projects, thenget_brandto read the profile. Create a project withcreate_projectif there is none, and pollget_branduntil it is ready.generate_ideasfor a goal and channel, or skip to a brief.create_creationwith anidea_idor abrief. Read the checks it returns and fix errors withupdate_creation.render_creation, then pollget_render. Download files from/api/assets/{id}/filewith the same key.