Skip to content
MCP server

Poseidon

Find which Meta ad formats, hooks and scripts win, using EU reach data, pay per search

Status and history

We have not yet received an answer to our tool-list check (latest attempt yesterday).

Install
Pricing
Freemium
Platforms
API, Web
Runs
Remotely
Version
1.4.0
Listing updated
3 days ago

About Poseidon

Poseidon is a freemium MCP server for marketing and seo. It runs as a hosted remote server, so there is nothing to install locally.

Its basis is Meta's public EU transparency data, which reports how many people saw each ad by country, age and gender. Poseidon reads that every day for the winning e-commerce ads it follows, 3,690 of them on the day the page was written. Reach is the number of people Meta says saw the ad, not sales, and each figure shows the date it was read.

The pitch is that ad longevity proves little, so the service compares versions instead. Examples on the site include one video with seven different texts whose reach differed twelvefold, and two ads that differed only in the first line. Scripts are split sentence by sentence into hook, problem, proof and offer, and brands' own A/B tests are surfaced with the winner and both ads. Format weights are shown with their sample size and withheld below 30 ads.

You can ask for a competitor's changes since a date, or filter by country and audience share. Billing is prepaid credits at EUR 0.01 each: a search costs 5, one ad with its script 2, format analysis 10. Searches that find nothing are free, and new keys start with 100 free credits.

Install

Run in a terminal

claude mcp add --transport http poseidon https://api.askposeidon.app/mcp

Add to Settings → Connectors → Add custom connector

https://api.askposeidon.app/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "poseidon": {
      "url": "https://api.askposeidon.app/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "poseidon": {
      "type": "http",
      "url": "https://api.askposeidon.app/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "poseidon": {
      "serverUrl": "https://api.askposeidon.app/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "poseidon": {
      "type": "http",
      "url": "https://api.askposeidon.app/mcp"
    }
  }
}

Tools this server provides (14)

Read directly from the server.

search_winners
Find winning e-commerce ads (Facebook / Instagram, Meta Ad Library) and show what's working. Use it FIRST when the user asks for winning ads, what's working or scaling in a niche or a country, the best hooks, the longest-running ads, or ads that reach a given age and gender. Examples: 'winning ads for weight loss in France', 'which hooks work for menopause in Germany' (has_script=true: each result
get_ad
One ad in full, by its Meta Ad Library id. Use it to read an ad's whole script, see how it is built, or check one ad the user names ('show me the script of ad 862034243491035', 'break down this ad'). Returns the verbatim script sentence by sentence, each labelled Hook, Problem, Agitation, Mechanism, Proof, Product, Offer, CTA…, the ad text and title, format, dates, days live, versions, EU reach hi
find_brand
Find a competitor by name or shop domain, before get_brand or brand_changes. Use it whenever the user names a brand or store ('show me Epycure's ads', 'what is Leaf running', 'gymshark.com'). Fuzzy: returns up to 10 confirmed e-commerce brands, best first, each with what matched (page name or shop domain), its page_id, shop link, and how many ads, winners and active ads Poseidon holds. No search o
brand_changes
Watch a competitor: what changed for one brand since a date. Use it for 'what's new from <brand>', 'did they launch or stop ads', 'what is scaling for them this week'. Returns, each with its date and source: ads started (Meta's start date), ads stopped (Meta's stop date), ads whose version count rose, new ads relaunching a media the brand already used, and the ads whose EU reach grew most between
watchlist_edit
Save competitors to watch, on your key: add or remove brands by page_id (get it with find_brand), up to 25. Use it when the user says 'watch these brands', 'add X to my competitors', 'stop watching Y'. Only confirmed e-commerce brands can be added. Returns the watchlist. Free.
get_facts
Weighted facts about what wins, each with its sample and its odds: e.g. 'in weight loss, EU, same brand and same launch day, video reached more people than image in 28 of 40 brands (70%, 95% interval 55-82%, p = 0.017)'. Use it when the user asks what is proven, what works better, video or image, or wants evidence rather than examples. Only facts that pass today are returned (30+ brands, p < 0.05,
watchlist_webhook
Get pushes instead of polling: set an https URL on your key and Poseidon POSTs the new changes of your watched brands (new ads, stopped ads, more versions, reused media, reach growth) about every hour, signed with HMAC-SHA256 (header Poseidon-Signature: t=…,v1=…; the secret is returned once when the URL is set), retried with backoff for about 15 hours. Each push costs what watchlist_changes costs
watchlist
The brands saved on your key's watchlist (page_id, name, shop, date added). Free.
watchlist_changes
What changed across ALL your watched competitors since a date, in one call. Use it for 'what's new from my competitors', 'weekly competitor report'. Same content, dates and sources as brand_changes, grouped by brand; brands with no change are listed apart. Also says how many watched ads have at least two reach readings since the date (reach growth can only be shown for those). Costs 5 credits per
get_brand
What one brand or shop is running on Meta. Use it when the user names a store or brand ('what is epycure.com running', 'how long do Leaf Co's ads last'). Give the shop domain (e.g. epycure.com) or the Meta page id. Returns the shop (link, platform), the brand's ads in Poseidon by format, how many are winners, the median days live (when 30+ ads), its 10 longest-running ads with reach, links and ver
search_experiments
Brands' own A/B tests and which version won. Use it when the user asks what brands tested, which video, text or hook won, or for 'A/B test' or 'split test' results ('did shapewear brands in France test different videos with the same text, and which won?'). A test = ads of one brand launched within 14 days that share one element and differ in another: same video with different texts, same text with
get_weights
Medians and statistics across many ads (not single ads): the median days live, median EU reach or median versions of a format, niche, country or target, with the sample size. Use it FIRST for any question about a median, an average, a typical value or a comparison of formats: 'median days live of video ads in weight loss', 'do videos last longer than images', 'which format reaches more'. Each row:
filters
Free. The values Poseidon accepts, with live counts: niches, Meta formats, countries with reach data, age bands, sort orders, the winner rule and the coverage. Call it when unsure of a niche name or a country code, or when the user asks what Poseidon covers.
account
Free. Credits left (they never expire), prices per call, the last calls and credit movements. Use it when the user asks about credits, balance, usage or cost.

What it does

Reach by audience
Shows EU reach for each ad with country, age and gender breakdowns.
Labelled scripts
Splits ad scripts into hook, problem, proof and offer.
Brand A/B tests
Finds brands' own tests and reports which version won and by how much.
Competitor changes
Lists what a watched brand changed since a given date.
Watchlist and webhook
Follow brands and receive change deliveries through a watchlist webhook.
Sample-size guard
Shows format weights only when based on at least 30 ads.

Good for

  • Find winning ads in a country where a target age and gender share is high
  • Study the hooks winners use in the first seconds
  • Check what a competitor changed since last month
  • Compare versions of the same creative before copying one
  • Watch a list of rival brands for new ads

Pricing

Freemium

100 free credits, then prepaid credits at EUR 0.01; packs from EUR 20

Prices change. Check askposeidon.app before you buy.

Poseidon FAQ

How much does it cost?

Credits are EUR 0.01 each. A search costs 5 credits, a full ad with script 2, and format analysis 10; a search that finds nothing is free.

Is there a free tier?

New accounts get 100 free credits, about 20 searches, with no card. The site also lets you ask 3 free questions a day without a key.

Is it a subscription?

No. Credits are prepaid and never expire.

What does reach mean here?

The number of people Meta says saw the ad, taken from its EU transparency data. It is not a sales figure.

Which ads does it cover?

Winning e-commerce ads that appear in Meta's EU Ad Library data.

Is Poseidon free?

Poseidon has a free plan, with paid plans for more usage or features.

How do I add Poseidon to Claude Code?

Run this command in your terminal: claude mcp add --transport http poseidon https://api.askposeidon.app/mcp

What are the best alternatives to Poseidon?

The closest alternatives to Poseidon are Google Ads + Meta Ads + SEO/GEO MCP, Calven, MCP, Red Center Studio free tools and ASOScan.

Alternatives to Poseidon

  1. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  2. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  3. MCP

    MCP server

    MCP server for planning, scheduling and measuring social and ad campaigns with approvals

    • Remote
    • Freemium
    • Marketing and SEO
  4. Free website checks for AI readiness, DNS dependencies, domain health and Bubble errors

    • 5 tools
    • Remote
    • Free
    • Marketing and SEO
  5. ASOScan

    MCP server

    ASO data for your own iOS and Android apps: rankings, keywords, reviews, scores

    • Remote
    • Free trial
    • Marketing and SEO
  6. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO