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 Claude Code, Codex, claude.ai, ChatGPT, or another MCP client to your creative memory.
Billing and plans
Understand the $29 plan, classification usage, history imports, and what a lapsed subscription keeps.
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, then either connect an MCP client with OAuth (sign in when prompted) or copy your API key from Settings for the API or an OAuth-less MCP client. There is no free tier and no trial: a new account is read-only until it subscribes, and nothing is classified until it does.
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 and scheduled refreshes use this same durable pipeline; connected workspaces become due every 8 hours by default, and an already-running workspace is skipped safely. The app shows whether the latest data is fresh, updating, partial, stale, failed, or unavailable, and an open tab rechecks that status periodically and when you return to it. Every completed analysis includes standard attributes, and may include brand_attributes plus recognized_entities. At launch, the API accepts uploaded images, videos, and carousels plus supplied email HTML. Remote file_url, video_url, and page_url inputs remain in the compatibility contract but temporarily return customer_url_fetch_disabled; synced destination reporting remains available.
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 your first ad account's history (36 months by default, any depth up to Meta's 37-month retention limit), once per account. Each additional ad account's history import is started by the account owner and comes out of your credits: your monthly classifications, then $0.10 each. 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. Workspaces are unlimited, but several ad accounts cost more in usage than one: each additional account's history import and ongoing classifications count toward your monthly classifications.
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. The API includes prebuilt and custom report routes; the launch dashboard exposes the core Strategy matrix and Creatives report presets while dedicated Trends and Best Landing Pages surfaces remain feature-gated. 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, now with standard MCP OAuth (dynamic client registration, PKCE) — add the URL in your client and sign in, no key-copying required. 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 with 43 tools. Discover tools from the connected server; hosted and local capabilities differ.
Claude Code — claude mcp add --transport http creative-tagger https://api.creativetagger.ai/mcp/ then claude mcp login creative-tagger (or /mcp inside a session)
Codex CLI / IDE / ChatGPT desktop Codex host — codex mcp add creative-tagger --url https://api.creativetagger.ai/mcp/ then codex mcp login creative-tagger
claude.ai (web, desktop, mobile) — Settings → Connectors → Add custom connector → paste https://api.creativetagger.ai/mcp/ → Connect
ChatGPT — Settings → Connectors → Advanced → Developer mode → add the URL
Cursor, VS Code, Gemini CLI, Windsurf, and other MCP clients — add the URL to the client's MCP config; its own OAuth prompt fires on first use
Grok and any client without OAuth discovery — use the API key path instead: Authorization: Bearer ct_your_key (or X-API-Key)
For stdio-only clients, install creative-tagger-mcp==0.2.4. Discover tools from the connected server; hosted and local capabilities differ.
Manage or revoke a connected assistant any time under Settings → Connections. See the complete tool, prompt, resource, and agent-instruction reference in llms.txt, or use the interactive REST docs at api.creativetagger.ai/docs.
$29 a month. Usage above that.
There is no free tier and no trial. One subscription covers the whole account: every workspace and every user. Usage, not seats or workspaces, is the meter. Runtime checkout availability comes from GET /billing/plans.
Creative Intelligence Beta
$29 a month per account unlocks all 21 dimensions, full paid analytics, and unlimited workspaces and users. It includes 300 successful classifications each month; each additional successful classification is $0.10, and classification is never blocked by your allowance.
History imports
Your first ad account's history (36 months by default, any depth up to Meta's 37-month retention limit) is included once per account. It starts automatically after that account's first sync and does not use your monthly classifications. Each additional ad account's history import is started by the account owner after an estimate, and comes out of your credits: your monthly classifications, then $0.10 each; it never bills beyond the estimate you accept. The app never opens a separate backfill purchase.
Several ad accounts cost more
Several ad accounts cost more in usage than one. Every additional account's history import and ongoing classifications count toward the same monthly classifications, then $0.10 each.
Classification billing
One successful customer classification is one billing unit regardless of image, video, carousel, landing-page, or email format. Automatic classification after a Meta sync, on-demand classification, and additional ad accounts' history imports all count. Failed classifications and your first ad account's included history import do not.
Lapsed or unpaid accounts: read-only
An account without an active subscription is read-only. A lapsed subscription keeps read-only access to everything already imported; classification stops until payment resumes. An account that has not subscribed yet can sign in, connect Meta, and subscribe, and nothing is classified until it does.
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.
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/. OAuth-capable clients (Claude Code, Codex, claude.ai, ChatGPT) should prompt to sign in on first use — if the prompt does not appear, remove and re-add the connector. For bearer-token clients, confirm CREATIVE_TAGGER_API_KEY is visible to the process that launches the client. Grok and other clients without OAuth discovery need the 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. Discover tools from the connected server; hosted and local capabilities differ.
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