eonik-mcp
OfficialUse eonik as an assistant-facing research, strategy, memory, and briefing backend for a brand’s ads and competitors; it is read-only toward ad platforms and the schema exposes no ad creation, resizing, launch, or edit tools.
Review recent Monday slates and consideration items, and get receipt-bound grounding to author creative briefs (or use the deprecated server-generated brief).
Pull brand DNA, brand briefing, context ledger, account condition, and account memory with auction-scoped winners/losers and craft standing.
Inspect the user’s own Meta ads: list ads, look up ad/campaign performance, and queue read-only ad syncs.
Monitor competitors: watch activity, channels and coverage, per-channel captured assets, timelines, ad-library searches, and configured competitor ads.
Analyze public creative: deconstruct ads scene by scene, read stored deconstructions, measure duration, retrieve clonable ad media, and aggregate competitor patterns/craft playbooks.
Explore category hashtag topics and the marketer’s saved swipe file.
Run pre-export validation with time-aware norms and draft comparisons.
Persist marketer knowledge: verbatim context notes, brand truths, dated plans, and durable remember/recall facts with history.
Enables reading Meta advertising performance data (spend, CTR, status) from the user's eonik account as facts to inform ad creative decisions.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@eonik-mcp Pull up our top performing Meta ads from last month and draft a brief based on the best one."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
eonik gets you finished, on-brand ads without the busywork. Your assistant can set eonik up for your brand, keep watch on the competitors you name, read how your own ads are doing, and have the eonik app on your Mac make every size of an ad, on-brand, checked, sent for approval and delivered. Nothing is made, changed or sent until you say so.
Setting up, competitors and your own ads work from any assistant. Making and resizing runs in the eonik app on your Mac (download · macOS 15+ · Apple silicon), where your files and fonts are.
What you can ask
Setting up
"Set eonik up for my brand, acme.com." eonik reads your site and sets up the brand.
"Watch Gymshark and this Ads Library link for us." A link is added at once; a name comes back as the page the Ad Library shows, for you to confirm.
"Invite sam@acme.com." · "Connect our Meta ad account." · "What plan are we on?"
Research
"What did our competitors change this week?" · "Break that ad down, scene by scene."
"How are our own ads doing?" · "What have we already tested?"
"Remember: we never show the old logo."
The work (in the eonik app on your Mac)
"Where are we?" What needs you, what is being made, what the client said.
"Adapt the spring master to the launch set, and add 1080x617." eonik makes every size and shows you each one before anything is final.
"Make the logo bigger on 300x250" · "Undo that." · "A Hindi version of this."
"Is this OK to send?" · "Check this zip against the media plan." · "Send it to the client."
"An ad for the summer sale" · "Recreate this ad with our product." eonik shows what it will cost first; nothing is made until you approve it.
Related MCP server: pitchboom MCP server
What it never does
It cannot pause, scale, launch or edit ads, and it cannot write to Meta, TikTok or Google Ads. It never says an ad "will work". It never makes a choice that is yours: making the sizes, approving, sending past a rule finding. Those are buttons you press, in eonik's panel or in eonik itself.
Connect
Every assistant on this computer, in one command:
npx eonik-mcp initIt adds eonik to Claude Code, VS Code, Cursor and Codex, each the way that assistant documents,
and says what to do in Claude Desktop. No key is copied: each assistant signs you in to eonik the
first time it uses it. npx eonik-mcp init --dry-run shows what it would do and changes nothing.
Claude (claude.ai, Desktop), ChatGPT, VS Code by hand: add the connector
https://api.eonik.ai/mcp and sign in with your eonik account.
Hosts that need a local process (Claude Desktop's config file, older setups): this package bridges them to the same server.
Create an API key in eonik (Settings, API keys).
Add this to the host's MCP config:
{
"mcpServers": {
"eonik": {
"command": "npx",
"args": ["-y", "eonik-mcp"],
"env": {
"EONIK_API_KEY": "eonk_live_..."
}
}
}
}EONIK_BRAND_ID is optional: with more than one brand, you choose in the conversation, and eonik
never guesses which client's work you mean. EONIK_API_URL defaults to https://api.eonik.ai.
The bridge forwards exactly what the server offers (tools, the panel, prompts and eonik's questions to you) and adds nothing of its own.
Security
Keep EONIK_API_KEY in your MCP host env. Do not commit it. See SECURITY.md.
Also
Download for Mac | eonik.ai/download · editor free · macOS 15+ · Apple silicon |
Connect an assistant | |
Homebrew | |
Save ads you see |
License
MIT. See LICENSE.
Available Tools
32 toolsdeconstruct_adAInspect
Ask eonik to do the busywork of deconstructing a PUBLIC ad — a watched competitor, a category ad-library ad, a TikTok ad, or a swipe-file item (scene-split + transcribe + structural analysis, on the server). Idempotent — returns the existing breakdown if already done. Then read it with get_ad_deconstruction. Use when the marketer says 'break this down' / 'analyze the structure of this ad'. (For the marketer's OWN footage, use get_shot_analysis — that's read on-device.)
Inputs: asset_id (required).
generate_creative_briefAInspect
(DEPRECATED — prefer get_brief_grounding + author it yourself.) Compose eonik's grounded creative brief for an approved slate item via a server model — a receipt-bound execution spec {shape, hook_options[3], script_skeleton[], references[], guardrails[]}. No performance predictions.
Inputs: slate_item_id (required).
get_account_conditionAInspect
The brand's current operating condition from Meta-insight recency: {state: live | dark | not_connected, last_active, days_since_active, active_ads_recent}. Facts, never a verdict. A dark account needs a different first message than a live one — check this before advising.
Inputs: no named parameters.
get_account_memoryAInspect
What the user has tested in their OWN ad account, with receipts. Returns scopes (the auctions the account actually buys - objective + optimization goal + funnel stage), by_dimension allocation (spend and ad counts per creative dimension), and winners/losers where each ad is compared ONLY against the median CTR of its own auction, carried on scope_median_ctr. Rates are never comparable across auctions: on a live account two top-of-funnel auctions sit 41x apart on CTR from the optimization goal alone, so median_ctr is null and by_dimension[].avg_ctr is null wherever that value spans auctions. winners + losers equals judged_ads, not tested_ads - ads in an auction too thin to have a median appear in neither. Two horizons, and they answer different questions: craft_profile is a 90-day rolling snapshot - what separates the ads above their auction's median RIGHT NOW, and it can never say how long that has been true. craft_standing is the decay-weighted read across CLOSED weeks - held is what keeps separating, faded is what used to and stopped (which is the more useful half: it is how the account forgets last season on purpose). Never describe a craft_profile row as having held or worked for weeks - only craft_standing carries that, and only with weeks_separating of weeks_seen beside it. craft_standing is null until two weeks have closed; that is an honest silence, not an absence of craft. ⚠️ held means the choice keeps SEPARATING the two arms - not that it keeps working. Read latest_delta: a NEGATIVE delta means that craft choice is more common among the ads BELOW their auction's median. Always state the direction from the row's own counts, and never call a held row a thing that worked without checking its sign. Facts only, no predictions. Empty if Meta is not connected.
Inputs: no named parameters.
get_ad_deconstructionAInspect
eonik's scene-by-scene breakdown of a PUBLIC ad (a watched competitor, a category ad-library ad, a TikTok ad, or a swipe-file item): full transcript, genome, and every scene (timing, role, shot_type, camera, lighting, on-screen text, action, product visibility, dialogue). The labor eonik already did with ffmpeg + Whisper + Gemini, stored once per unique creative and reused across the fleet — use it to reason about creative STRUCTURE. Facts only. If none exists yet, call deconstruct_ad first.
Inputs: asset_id (required).
get_ad_for_cloneAInspect
ONE archived public ad by id, with the durable media needed to clone it (video, poster, permalink, copy). Use when a deep link or a slate item names an asset the local corpus does not hold — resolution by id, never a scan of a cached page. Returns clonable=false with a reason when only a still was archived.
Inputs: asset_id (required).
get_brand_briefingAInspect
Orientation for THIS brand: who it is, its rails, what the marketer has told us verbatim, what CHANGED in its competitive field since you last worked on it, and an inventory of every corpus you can reach with the tool that reaches it (counts, not contents). The editor loads this automatically at session start — call it yourself to refresh mid-session, after switching brands, or when you need to know what is actually available before choosing a tool.
Inputs: no named parameters.
get_brand_contextAInspect
The user's full brand DNA: name, category, audience, selling points, tone, positioning, messaging guardrails, personas, product catalog, competitor positioning. Use for any strategic brand question.
Inputs: no named parameters.
get_brief_groundingAInspect
Get the receipt-bound GROUNDING for a slate item's brief — the marketer's brand truths, account-evidence target grammar, the deconstructed reference's measured teardown, brand guardrails, and the verified receipts — as DATA. YOU then author the brief from it ({shape, hook_options[3], script_skeleton[], references[], guardrails[]}); eonik hands you the facts, you do the reasoning. Ground every reference in a receipt; no performance predictions. Use when the marketer says 'write the brief for #2' / 'turn that into a brief'. (Prefer this over generate_creative_brief — you author, not a server model.)
Inputs: slate_item_id (required).
get_campaign_performanceAInspect
Spend, CTR, and creative-genome breakdown for one of the user's OWN campaigns by name (partial) or exact campaign ID. Shows which hook_type x creative_style combinations are running and how each performs. Facts only, no predictions.
Inputs: identifier (required).
get_category_topicsBInspect
The category conversation pulled by hashtag: every watched TOPIC (a named hashtag bundle, e.g. 'UPSC prep' = #upsc #ssc #currentaffairs) with its captured Instagram post count. Topics are the wider field, not owned competitors. Load a topic's posts with get_competitor_assets(competitor_id=topic_id, channel='instagram_hashtag'). Facts only.
Inputs: brand_id.
get_competitor_assetsAInspect
One competitor's captured ads for ONE channel, page by page, newest-published first, with a whole-set summary (totals, run lengths, video mix, coverage). Every ad carries a watch_asset_id so it can be deconstructed. Use after get_competitor_channels to load a channel tab. channel is a canonical slug: meta_ad_library | tiktok_ad_library | google_ads_transparency | instagram_organic | instagram_hashtag.
Inputs: channel (required), competitor_id (required), limit, offset, +1 more.
get_competitor_channelsAInspect
The 24/7 watch back office: every competitor under watch with their per-channel captured-ad counts (Meta Ads, TikTok, Google/YouTube, Instagram) + coverage (whether stops are observable on each channel), and each channel's read state so 'never polled' is distinguishable from 'polled, nothing found'. Use to show the Competitors rail and channel tabs, or to answer 'which competitors do we watch and how much do we have on each?'. Facts only — counts and date ranges, never a score.
Inputs: brand_id.
get_competitor_patternsAInspect
Aggregated structural patterns across ALL of a competitor's deconstructed ads — e.g. 'X of Y ads open with a problem-solution hook', most common editing rhythm, most common first-scene shot. Counts only, no predictions. Requires at least one deconstructed ad for that competitor.
Inputs: competitor_id (required).
get_competitor_timelineAInspect
The full chronological roster of ONE competitor's archived creatives — every ad eonik has watched, newest launch first, with lifespans (how long each ran, whether it's still live) and archived media that survives after the ad is pulled. The continuous-monitoring archive Claude can't reconstruct. observed_* = eonik's monitoring window; platform_* = the platform's own claims (kept separate). Each item has an asset_id you can pass to deconstruct_ad to go deeper. Facts only, no predictions.
Inputs: competitor_id (required), limit, channel, active_only.
get_context_ledgerAInspect
Everything the marketer has told eonik — durable brand truths (what 'working' really means, which customers are worth more, hard-won creative beliefs, economics), dated upcoming plans (sales/launches/seasonal), and recent verbatim corrections. The proprietary input no competitor or general agent can scrape. ALWAYS read this before giving strategic advice — it overrides generic best practice. Facts, verbatim.
Inputs: no named parameters.
get_craft_playbookAInspect
HOW a competitor's surviving ads are actually made — the pointers a video editor can build from: the hook and its verbatim opening lines, when the brand/product first appears on screen, average shot length, opening beat cadence, whether it reads with sound off, production style and tier, who is on camera, and the on-screen text they reuse. Each pointer carries counts from the ads that LASTED and, where the evidence allows, from the ones that ran far shorter. Use when asked 'what works for ', 'how do they make their ads', or when briefing an editor. Descriptive only: these are counts over what survived, never a claim that a technique CAUSED the survival. Returns unavailable with a reason when too few of that brand's creatives have been analysed — say that plainly rather than filling the gap.
Inputs: competitor_id (required).
get_my_competitor_adsAInspect
Get ads from the user's configured competitors (the brands they watch) — facts only (creative, hook, days-running), no scores or predictions. Use for 'what are my competitors running?'.
Inputs: limit.
get_recent_slatesAInspect
Get the user's recent Monday slates and consideration items (concept, why-now, receipts, reactions). Use for questions about their slates.
Inputs: limit.
get_validation_groundingAInspect
The time-aware NormsPack for the pre-export reality check — scoped (own/category/competitor), windowed (28d/90d/lifetime) pattern facts with survivor rates, temporal class (evergreen|rising|fading|breaker), denominators, exemplar receipts, brand rails, and precomputed draft_comparisons. Pass the draft's signature so the pack is conditioned on THIS draft. Facts + arithmetic only — descriptive, receipt-backed, never predictions. Degrades honestly per scope.
Inputs: aspect, medium, draft_text, offer_text, +5 more.
get_watch_activityAInspect
Recent activity from the competitors the user is watching - new ads, proven winners (30+ days), organic outliers - with receipts. Use for 'what are my competitors doing lately?'.
Inputs: days.
list_my_adsAInspect
List the marketer's OWN ads with the full performance dashboard — spend, CTR, CPM, CPA, ROAS, hook rate (3s-view rate), hold rate (completion), status, creative genome, and thumbnail. Ranked by recent spend. Powers the Ad Library 'Your ads' corpus. Facts only, no predictions.
Inputs: days, limit.
lookup_ad_performanceAInspect
Quick lookup of a specific OWN ad's performance: spend, CTR, CPC, impressions, status, genome tags. Use for 'what's the CTR on [ad]?', 'how is [ad] performing?'.
Inputs: ad_name_or_id (required), days.
probe_asset_durationAInspect
Measure how long a PUBLIC ad's creative actually runs, in seconds, and remember it. Reads the header of the copy we already hold (no download, no third-party CDN). Returns {duration_seconds} — or null when the media cannot be measured, which means UNMEASURED, never zero. Use before acting on an ad's length when the corpus says its duration is unknown.
Inputs: asset_id (required).
recallAInspect
What has this brand's marketer already decided, corrected or rejected? Semantic search over the brand's own memory, returning facts with their validity windows and receipts. Superseded facts are excluded unless you ask for history — quote valid_from/invalid_at rather than presenting an expired fact as current. Call it before proposing anything the marketer may have already ruled on.
Inputs: query (required), as_of, limit, include_history.
rememberAInspect
Record something durable about THIS brand that you learned from the marketer — a decision, a correction, a rejection, an outcome. State it as a relation you already understand: subject + relation + object, plus the fact in one sentence and the marketer's own words if they said it. Recording 'the hook is X' when 'the hook is Y' was recorded before automatically supersedes the old fact (it becomes history, not a contradiction). Use it when the marketer tells you something that should still be true next session; do NOT use it for chit-chat or for anything already in the brand context.
Inputs: fact (required), subject (required), relation (required), quote, +5 more.
save_brand_truthAInspect
Capture a STRUCTURAL business truth the marketer reveals — something that should permanently shape the slate because it's what the platform's vanity metrics can't see. Four kinds: objective (what 'working' really means — e.g. 'we only care about repeat buyers, not first orders'), value_gradient (which customers are worth more than they look — e.g. 'our video ads bring people who deposit 2-3x more'), creative_truth (a hard-won belief — e.g. 'discounts bring people who never come back'), economics (AOV/margin/repeat cadence). Call ONLY for durable business truths, NOT one-off plans (those go to save_context_note). Capture their words VERBATIM in statement. Tell them you've noted it and they can edit it in Brand.
Inputs: kind (required), statement (required).
save_context_noteAInspect
Save a one-off correction or preference the marketer tells you to their context ledger, VERBATIM (e.g. 'we killed that angle', 'founder hates UGC'). NOT for questions or small talk; NOT for a dated plan/sale/launch (use save_plan); NOT for a durable business truth (use save_brand_truth). After saving, tell them you remembered it and they can review or remove it in Brand. Never rewrite their words.
Inputs: text (required), source.
save_planAInspect
Capture a DATED upcoming plan the marketer mentions — a sale, launch, or seasonal moment the Monday slate should prepare creative for WITH LEAD TIME (e.g. 'Diwali sale starts Oct 20', 'we launch v2 in March', 'Black Friday'). Provide title VERBATIM and starts_on as an ISO date YYYY-MM-DD; add ends_on if they give a range. ALWAYS read the date back to them in your reply so they can confirm or correct it. NOT for vague intentions without a date (use save_context_note); NOT for durable business truths (use save_brand_truth).
Inputs: title (required), starts_on (required), kind, ends_on.
search_competitor_adsAInspect
Search the ad library for competitor ads. Returns ads with hook types, creative styles, run duration. Use to analyze competitor creatives, find inspiration, or see what a brand is running.
Inputs: limit, industry, hook_type, brand_name, +1 more.
search_swipeAInspect
The marketer's OWN saved swipe file — ads they personally curated — with eonik's enrichment (days-running, spend range, audio, variations). Use to ground a question in what the marketer themselves has saved/admired.
Inputs: limit, brand_name.
sync_my_adsAInspect
Queue a read-only sync of the marketer's OWN Meta ads + insights (the same job that runs nightly). Use when their ad library looks empty or stale and Meta IS connected. Returns queued + last_synced; the ads land in list_my_ads a few minutes later. Read-only — never writes to Meta.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 32 tools
Several tools cluster around overlapping concepts: brand/marketer memory (get_brand_context, get_context_ledger, get_brand_briefing, get_account_memory, remember, recall) and competitor/ad reads (get_watch_activity, get_my_competitor_ads, get_competitor_assets, get_competitor_timeline). The descriptions include explicit routing hints and many tools are genuinely distinct, but an agent could easily select the wrong one in these clusters.
The set is dominated by a get_* + resource pattern, with consistent save_* groups and the list_my_ads/sync_my_ads pair. Deviations like remember, recall, lookup_ad_performance, probe_asset_duration, and deconstruct_ad break the pattern, but the naming remains readable and mostly predictable.
With 32 tools, the surface exceeds the 25+ too-many threshold, and the count feels inflated by a deprecated duplicate (generate_creative_brief) and several overlapping memory/context tools. The server's scope is broad, but the tool set is heavier than its core workflows require.
Core read, search, sync, save, and deconstruction workflows are well covered. However, the write-side lifecycle is thin: there is no tool to update or delete saved context/plans/truths, no competitor-watch management, and the deprecated brief-generation flow leaves no way to persist an authored brief, creating notable dead ends.
Maintenance
Related MCP Connectors
Real-time Meta, Google, LinkedIn and TikTok ad library access for AI assistants. No API keys.
Connect authorized ad accounts to AI assistants for audits, reporting, and approval-gated changes.
Your brand's Styles, logos and asset library in your AI app, for on-brand assets that match.
Ready-to-publish ad creatives from an AI assistant: campaigns, image/video/UGC ads, brands, edits.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceConnects AI assistants to 27 marketing and analytics platforms, enabling read-only access to data, built-in tracking audits, and KPI context for informed answers.Apache 2.0
- AlicenseNot gradedqualityCmaintenanceConnects AI assistants to a hosted motion-design studio that turns a product URL or brief into editable storyboard-based video ads, with quotes for paid steps approved before credits are spent.MIT
- AlicenseNot gradedqualityCmaintenanceConnects the AI assistant a business already uses to its Google Ads, social accounts, Shopify store, inventory and a phone line, so it can create campaigns, publish and schedule posts, manage products and orders, and place or answer calls. Ad spend and other writes are held behind an owner approval gate, and each connection is limited to the workspaces and permissions the user grants.MIT
- AlicenseBqualityCmaintenanceEnables AI assistants and agents to read analytics and manage advertising across Google Ads, Google Analytics 4, and Meta Ads through natural language, with preview-confirm guardrails and configurable account and budget limits.21MIT