Get from first creative to useful strategy.
Use these docs to set up your workspace, train Brand Brain, sync Meta performance, and connect Creative Tagger to the AI tools your team already uses.
- 1Create an account and pick a brand workspace.
- 2Connect Meta in Settings with read-only OAuth and choose the ad account.
- 3Sync ad-level performance — synced ads are analyzed into Creatives.
- 4Add founder, product, offer, segment, and campaign terms in Brand Brain.
- 5Ask the strategist for winners, gaps, briefs, and naming conventions.
Quick start
Create your account, choose a brand workspace, connect Meta, and review your first analyzed creatives.
Brand Brain
Teach the strategist brand-specific values, aliases, entities, and naming fields.
Performance memory
Bring in read-only ad performance so Creative Tagger can show what tags win or stall.
Chat and briefs
Use the in-app strategist to ask about your library, generate briefs, and plan new tests.
MCP setup
Connect Codex or another bearer-token Streamable HTTP MCP client to your creative memory.
Billing and plans
Understand the free read-only floor, classification credits, and monthly plans.
Troubleshooting
Fix common API key, Meta sync, and local MCP issues.
Your first workspace
A workspace is built around a brand. The standard taxonomy stays consistent across every brand, while brand-specific context lets the app recognize your people, products, offers, segments, and internal labels.
1. Create an account
Open the app, sign up, and copy your API key from Settings if you plan to use the API or MCP. Free accounts expose a rolling 7-day view over hook, angle, creative type, and emotion; they do not include self-serve generation credits.
2. Pick or create a brand
Use the workspace switcher in the sidebar. Keep each ad account or client in its own workspace so taxonomy memory and performance stay clean.
3. Connect Meta and sync
Open Settings, connect Meta with read-only OAuth, and choose an ad account. The automatic initial refresh after account selection starts the tracked full pipeline: performance and demographics, followed by bounded sample classification and degraded-media retry. Wait for the sync job reported in Meta status before judging tags or Strategy. The explicit Sync action runs this same full pipeline; the separate scheduled refresh remains performance-only and runs every 8 hours by default. Every completed analysis includes standard attributes, and may include brand_attributes plus recognized_entities. The API and MCP also analyze images, videos, carousels, landing pages, long videos, and emails directly.
4. Review in Creatives
Open any creative in Creatives to inspect the asset, play video, review tags, and export naming conventions. Saved analyses become memory for reports and the strategist.
Keep the standard layer. Add your brand language.
Creative Tagger is designed to avoid the Motion-style problem of getting stuck inside someone else's fixed vocabulary. The app preserves standard reporting fields, then lets each brand add its own allowed values, aliases, descriptions, and entities.
Open Brand BrainValues
Add brand-specific values to existing dimensions, such as a named audience, offer family, messaging theme, creator type, or internal campaign label.
Aliases
Map alternate names to the same value. Example: "JL", "Jordan", and "Jordan Lee" can resolve to the same founder entity.
Entities
Create founders, customers, creators, products, spokespeople, offers, ICPs, and segments that the analyzer can recognize from copy, transcript, metadata, or naming.
Naming templates
Use standard fields plus brand fields such as founder, product, customer_segment, and campaign_label.
Connect performance without giving write access.
Meta access is read-only. Creative Tagger connects with ads_read, syncs ad-level performance, matches it to analyzed creatives, and summarizes what standard and brand-specific tags are winning, watching, or unproven.
Native Meta OAuth
Connect from Settings. Creative Tagger requests read-only access for Ads Insights and stores the synced performance alongside your analyzed creatives.
Sync window and history
Sync defaults to the latest 30 days of ads, spend, clicks, conversions, revenue, demographics, and video milestones. Creative Intelligence Beta includes one completed historical Meta import per subscriber across all workspaces and Meta accounts, up to 37 months. No separate backfill checkout is required.
One workspace, one ad account
Each workspace links to a single ad account, and the link locks after the first sync. To analyze a different ad account, create a new workspace.
No write access
Creative Tagger does not create campaigns, edit budgets, publish ads, or write back to Meta.
Reports
Strategy shows spend, ROAS, CTR, thumbstop, funnel score, and coverage gaps by standard taxonomy and Brand Brain dimensions. Prebuilt reports cover hooks, landing pages, angles, audiences, offers, CTAs, visual formats, and brand-custom values, plus saved custom combination reports such as hook × landing page × offer or founder × audience. Read the prebuilt and custom reports workflow for examples.
Ask questions against your creative memory.
The strategist reads your creatives, Brand Brain, recognized entities, and performance memory. Use it to find patterns, write briefs, compare creative types, and decide what to test next.
Give your AI access to the same context.
Use the hosted MCP endpoint for the current hosted surface. It lets an AI client discover workspaces, search the creative library, read performance and Strategy, use Brand Brain context, and create briefs. The published creative-tagger-mcp==0.2.4 package is the current local stdio surface: it exposes 43 stdio tools, while the hosted endpoint currently exposes 22 tools.
For Codex CLI, the IDE extension, or the ChatGPT desktop app's Codex host, add the Streamable HTTP URL in MCP settings or ~/.codex/config.toml and use bearer_token_env_var = "CREATIVE_TAGGER_API_KEY". ChatGPT web apps and Claude hosted connectors require OAuth and are not enabled yet. For stdio-only clients, install creative-tagger-mcp==0.2.4. Discover tools from the selected transport rather than assuming the 43-tool stdio surface and 22-tool hosted surface are identical.
Authentication also accepts X-API-Key. See the complete tool, prompt, resource, and agent-instruction reference in llms.txt, or use the interactive REST docs at api.creativetagger.ai/docs.
Free agent access. Paid creative intelligence.
The permanent free floor is built for MCP and API exploration. The discounted beta plan unlocks the full taxonomy, longer history, classification, briefs, reports, and the rest of the analytics surface. Runtime checkout availability comes from GET /billing/plans.
Free
A rolling 7-day view over four dimensions through MCP/API reads, plus dashboard access. No card and no self-serve generation credits.
Creative Intelligence Beta
Discounted $29/month beta access unlocks all 21 dimensions, full paid analytics, one completed historical Meta import per subscriber across all workspaces and Meta accounts (up to 37 months), and up to 72 successful classifications per month; each additional successful classification is $0.40.
Beta catalog
Creative Intelligence is the only self-serve paid offer for new beta customers. Growth and Scale remain recognized only for legacy account records; GET /billing/plans is the source of truth for checkout availability.
Classification billing
One successful customer classification is one billing unit regardless of image, video, carousel, landing-page, or email format. Failed classifications and the included history import do not create customer overage events.
History backfill
An active Creative Intelligence Beta subscription includes one completed historical Meta import per subscriber across all workspaces and Meta accounts, up to 37 months. The app counts the available ads before starting the included import; it never opens a separate backfill purchase.
Common fixes
My API key is not working
Check Settings in the app and pass the key as X-API-Key or Authorization: Bearer. Rotate the key if it was exposed.
My creative is not matching performance
Make sure the Meta ad name includes the same naming convention or filename as the analyzed creative. Start with one known ad and verify the match.
The model missed a founder or product
Add that person or product as a brand entity, include aliases, and re-run the creative. Recognition is entity and prompt based, not biometric face recognition.
MCP is not showing tools
For hosted MCP, confirm the URL is https://api.creativetagger.ai/mcp/, the client supports Streamable HTTP bearer authentication, and CREATIVE_TAGGER_API_KEY is visible to the process that launches Codex. ChatGPT web and Claude hosted connectors cannot use this API-key flow. For local stdio, confirm creative-tagger-mcp==0.2.4 is installed and that the subprocess can read the API key; the current package exposes 43 stdio tools, while the hosted endpoint exposes 22 tools.
Send us the workflow you are trying to run.
Include your brand name, the creative format, whether you are using dashboard/API/MCP, and what result you expected.
Email support