Creative Tagger Help Docs

Get from first creative to useful strategy.

Use these docs to set up your workspace, customize brand taxonomy, import Meta performance, and connect Creative Tagger to the AI tools your team already uses.

Fast path
  1. 1Create an account and pick a brand workspace.
  2. 2Add founder, product, offer, segment, and campaign terms in Brand Taxonomy Studio.
  3. 3Analyze creatives or import existing library rows.
  4. 4Import Meta performance by CSV or read-only connection.
  5. 5Ask the strategist for winners, gaps, briefs, and naming conventions.
Start

Quick start

Create your account, choose a brand, upload the first creative, and save the result.
Taxonomy

Brand Taxonomy Studio

Extend the standard taxonomy with brand-specific values, aliases, entities, and naming fields.
Meta

Performance memory

Bring in read-only ad performance so Creative Tagger can show what tags win or stall.
Strategy

Chat and briefs

Use the in-app strategist to ask about your library, generate briefs, and plan new tests.
AI agents

MCP setup

Connect Claude, Cursor, ChatGPT, or another MCP client to your creative memory.
Credits

Billing and plans

Understand free credits, pay-as-you-go usage, monthly plans, and checkout readiness.
Support

Troubleshooting

Fix common API key, upload, Meta import, and local MCP issues.
Quick Start

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 include starter credits.

2. Pick or create a brand

Use the brand switcher in the app header. Keep each ad account or client in its own brand so taxonomy memory and performance stay clean.

3. Analyze a creative

Use Analyze for images, videos, carousels, landing pages, long videos, or emails. The response always includes standard attributes, and may include brand_attributes plus recognized_entities.

4. Review and save

Open the creative detail view to inspect the asset, play video, review tags, and export naming conventions. Saved analyses become memory for reports and the strategist.

Brand Taxonomy Studio

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 Taxonomy Studio

Values

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: "SL", "Stephen", and "Stephen Lavender" can resolve to the 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.

Performance Memory

Connect performance without giving write access.

V1 keeps Meta read-only. Creative Tagger can import ad-level performance, match it to analyzed creatives, and summarize what standard and brand-specific tags are winning, watching, or unproven.

CSV import

Export a Meta Ads Manager report with ad names, destination URLs, and metrics, then upload it from Connect or Reports. This is the simplest V1 path and does not require a Meta app approval.

Direct import

Agents and MCP clients can send performance rows directly to the API. This is useful when a user pulls their own Meta data with their own tooling and wants Creative Tagger to become the memory layer. See the Meta app approval workaround.

Competitor rows

The same workaround supports competitor analysis. Paste CSV or JSON rows in Competitors, or have your AI call import_competitor_ads after it gathers Meta Ad Library rows with the user's own browser, CSV export, CLI, or MCP workflow.

Read-only OAuth

When your Meta app setup is approved, use the in-app Meta connection to sync read-only ad performance. Creative Tagger does not create campaigns, edit budgets, or write back to Meta in V1.

Reports

Reports show spend, ROAS, CTR, thumbstop, funnel score, and coverage gaps by standard taxonomy and brand taxonomy. V1 includes prebuilt reports for 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.

Strategist

Ask questions against your creative memory.

The chat reads your library, brand context, taxonomy, recognized entities, and performance memory. Use it to find patterns, write briefs, compare creative types, and decide what to test next.

// Example questions
What hooks are winning for high-intent founders?
Which products have the best funnel score?
Write a creative brief using our founder story angle.
What tags are unproven but strategically worth testing?
Turn the top five ads into naming conventions.
MCP Setup

Give your AI access to the same context.

Install the MCP server, set your Creative Tagger API key, and your AI client can analyze creatives, search the library, generate brand taxonomy, read performance summaries, import competitor rows, and create briefs.

pip install creative-tagger-mcp
{
"mcpServers": {
"creative-tagger": {
"command": "creative-tagger-mcp",
"env": {
"CREATIVE_TAGGER_API_KEY": "ct_your_key"
}
}
}
}

For REST details, use the interactive API docs at api.creativetagger.ai/docs.

Billing and Credits

Free to start. Usage-based when you need more.

Creative Tagger uses credits so teams can start without a sales call or seat negotiation. The dashboard and API both read the same live plan metadata from GET /billing/plans, including whether checkout is ready.

Free

50 credits/month with dashboard, taxonomy, reports, chat, and MCP setup. No credit card required.

Pay as you go

$0/month subscription with usage charged by credit after checkout is configured.

Monthly plans

Starter, Growth, and Scale include larger monthly credit pools for teams that analyze and report on creative every week.

Credit costs

Images, emails, carousels, landing pages, briefs, strategist calls, performance reads, and taxonomy generation are 1 credit. Short videos are 2 credits. Long videos start at 4 credits.

Troubleshooting

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 or imported row name includes the same naming convention or filename used in the library. 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. V1 recognition is entity and prompt based, not biometric face recognition.

MCP is not showing tools

Restart the AI client after adding the MCP config, confirm the command is on your PATH, and verify CREATIVE_TAGGER_API_KEY is set in the config env block.

Still stuck?

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