Skip to main content
Glama
eonik-mcp

eonik-mcp

Official

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 init

It 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.

  1. Create an API key in eonik (Settings, API keys).

  2. 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

eonik.ai/mcp

Homebrew

homebrew-tap

Save ads you see

Chrome extension

License

MIT. See LICENSE.

Available Tools

32 tools
deconstruct_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

    A3.6/5.0

    Scored across 32 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness3/5

    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

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Connects 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
    • A
      license
      B
      quality
      C
      maintenance
      Enables 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.
      21
      MIT