Poseidon

app.askposeidon/poseidonVersion 1.4.0

Winning Meta ads with Meta's EU reach, scripts and A/B tests. Find a competitor, see what changed.

Status

Responds174 msNov 14, 2026, 13:35 UTCAnswered our handshake without sign-in.

Registry data may be out of date

We could not refresh it, so this page shows the last copy.

Last checked: Nov 14, 2026, 13:35 UTC
Latency: 174 ms
Remotes responding: 1 of 1
Sign-in: API key
Hosting: Hosted outside the EU (detected)
Registry data as of: Nov 14, 2026, 22:14 UTC

Data from the official MCP Registry, checked by run.zero. How we check

Connect

Streamable HTTP

https://api.askposeidon.app/mcpResponds174 msNov 14, 2026, 13:35 UTC

No sign-in

Claude Code

claude mcp add --transport http poseidon https://api.askposeidon.app/mcp --header 'Authorization: Bearer <YOUR_TOKEN>'

Replace <YOUR_TOKEN> before running.

Claude Desktop and claude.ai

Settings > Connectors > Add custom connector
Name: poseidon
Remote MCP server URL: https://api.askposeidon.app/mcp
This server expects the header Authorization.

Cursor

{
  "mcpServers": {
    "poseidon": {
      "url": "https://api.askposeidon.app/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

Replace <YOUR_TOKEN> before running.

VS Code

code --add-mcp '{"name":"poseidon","type":"http","url":"https://api.askposeidon.app/mcp","headers":{"Authorization":"Bearer <YOUR_TOKEN>"}}'

Replace <YOUR_TOKEN> before running.

Built your own server? run.zero hosts MCP servers on European infrastructure.

Host your own MCP server on run.zero

Tools

14 tools

Tools of Poseidon
	Description		Read-only	Idempotent	Open world
`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.	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.	Not declared	Not declared	Not declared	Not declared
`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 two readings. Get the page_id with find_brand. Costs 5 credits (0 if nothing changed).	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 two readings. Get the page_id with find_brand. Costs 5 credits (0 if nothing changed).	Not declared	Not declared	Not declared	Not declared
`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.	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.	Not declared	Not declared	Not declared	Not declared
`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 of people's names: a page named after a person is found by its shop domain only. Free.	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 of people's names: a page named after a person is found by its shop domain only. Free.	Not declared	Not declared	Not declared	Not declared
`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 history (Meta's total per read day), country and age x gender shares of Meta's breakdown, links to the Ad Library and the shop, and the source of every field. Script sections (hook, problem, CTA…) are served only when every sentence has an English version or the script is in English; otherwise script.sections_status is 'translation_pending' and the transcript comes without section labels (being translated nightly); 'withheld' = this ad's sections can't be served (older breakdown without text). Costs 2 credits.	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 history (Meta's total per read day), country and age x gender shares of Meta's breakdown, links to the Ad Library and the shop, and the source of every field. Script sections (hook, problem, CTA…) are served only when every sentence has an English version or the script is in English; otherwise script.sections_status is 'translation_pending' and the transcript comes without section labels (being translated nightly); 'withheld' = this ad's sections can't be served (older breakdown without text). Costs 2 credits.	Not declared	Not declared	Not declared	Not declared
`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 verbatim hooks, and its A/B tests with a measured outcome. Poseidon reads up to 30 ads per brand page. Costs 5 credits.	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 verbatim hooks, and its A/B tests with a measured outcome. Poseidon reads up to 30 ads per brand page. Costs 5 credits.	Not declared	Not declared	Not declared	Not declared
`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, interval excluding 50%), with n, share, interval, p, method, read dates, caveats (always repeat them with the fact) and the commit of the code that computed them. Free.	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, interval excluding 50%), with n, share, interval, p, method, read dates, caveats (always repeat them with the fact) and the commit of the code that computed them. Free.	Not declared	Not declared	Not declared	Not declared
`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: dimension (format, niche, country, target…), value (e.g. VIDEO), signal (days_live, eu_reach, versions, active, share_in_country, relaunches, test_survivor), sample size, median, top 10%, and when it was computed. Rows under 30 ads are never shown. A row may carry a 'caveat' (today on days_live, active and test_survivor: ads that died young are missing, so survival is overstated): always repeat it with the number. For formats, format_pair_weight adds weights from paired experiments (same brand, two formats launched the same week): reach ratio A vs B with a 95% interval over brands, shown from 30 brands, a winner only when the interval excludes x1; quote its note (a strong hint, not a controlled test). Costs 10 credits (0 if nothing is returned).	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: dimension (format, niche, country, target…), value (e.g. VIDEO), signal (days_live, eu_reach, versions, active, share_in_country, relaunches, test_survivor), sample size, median, top 10%, and when it was computed. Rows under 30 ads are never shown. A row may carry a 'caveat' (today on days_live, active and test_survivor: ads that died young are missing, so survival is overstated): always repeat it with the number. For formats, format_pair_weight adds weights from paired experiments (same brand, two formats launched the same week): reach ratio A vs B with a 95% interval over brands, shown from 30 brands, a winner only when the interval excludes x1; quote its note (a strong hint, not a controlled test). Costs 10 credits (0 if nothing is returned).	Not declared	Not declared	Not declared	Not declared
`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 different videos (most tests), or same script with a different hook (rare). Each version: its ads with links, launch day, running or stopped, days live, EU reach, and the text that differs, whether the test is clean (only the tested element differs; this compares ad fields, not the video content: right 35 of 40 times in a hand check, so say it), plus a verdict: the version that reached most (with the ratio) when the gap is 2x or more; when the only signal is that one version stopped first, it says so and that this is not a confirmed outcome yet (repeat that). Only tests with a measured outcome are served (a version still running while another stopped, or 2x+ the reach). A summary covers all matching tests per kind (decided by survival, by reach, median reach ratio), shown only from 30 tests of a kind. Costs 5 credits (0 if nothing matches).	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 different videos (most tests), or same script with a different hook (rare). Each version: its ads with links, launch day, running or stopped, days live, EU reach, and the text that differs, whether the test is clean (only the tested element differs; this compares ad fields, not the video content: right 35 of 40 times in a hand check, so say it), plus a verdict: the version that reached most (with the ratio) when the gap is 2x or more; when the only signal is that one version stopped first, it says so and that this is not a confirmed outcome yet (repeat that). Only tests with a measured outcome are served (a version still running while another stopped, or 2x+ the reach). A summary covers all matching tests per kind (decided by survival, by reach, median reach ratio), shown only from 30 tests of a kind. Costs 5 credits (0 if nothing matches).	Not declared	Not declared	Not declared	Not declared
`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 carries its verbatim hook), 'longest-running video ads in Spain for bloating', 'ads launched last month with 1M+ EU reach' (started_after, min_eu_reach), 'ads that mostly reach women 45-54 in Germany' (age, gender, min_segment_share). Winner = live 21+ days (change with min_days_live). Each result: Ad Library link, shop link, format, days live, still running or stopped, versions, EU reach (Meta's total, with its read date), the country's or segment's share of Meta's breakdown, and the verbatim hook when the script is transcribed and fully in English or translated (sections_status 'served'; 'translation_pending' = no hook yet). Then call get_ad on the best ones for the full script. For medians or typical values across many ads, use get_weights instead. Values for niche, country and format: call filters (free). Coverage: e-commerce ads from Meta's Ad Library delivered in the EU and UK, read daily, with Meta's EU reach. Not covered: spend and impressions (Meta doesn't publish them for commercial ads), TikTok/Google ads. Creative types (UGC, VSL, demo…) and hook types are AI labels on part of the ads, served with their measured accuracy. Costs 5 credits (0 if nothing matches).	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 carries its verbatim hook), 'longest-running video ads in Spain for bloating', 'ads launched last month with 1M+ EU reach' (started_after, min_eu_reach), 'ads that mostly reach women 45-54 in Germany' (age, gender, min_segment_share). Winner = live 21+ days (change with min_days_live). Each result: Ad Library link, shop link, format, days live, still running or stopped, versions, EU reach (Meta's total, with its read date), the country's or segment's share of Meta's breakdown, and the verbatim hook when the script is transcribed and fully in English or translated (sections_status 'served'; 'translation_pending' = no hook yet). Then call get_ad on the best ones for the full script. For medians or typical values across many ads, use get_weights instead. Values for niche, country and format: call filters (free). Coverage: e-commerce ads from Meta's Ad Library delivered in the EU and UK, read daily, with Meta's EU reach. Not covered: spend and impressions (Meta doesn't publish them for commercial ads), TikTok/Google ads. Creative types (UGC, VSL, demo…) and hook types are AI labels on part of the ads, served with their measured accuracy. Costs 5 credits (0 if nothing matches).	Not declared	Not declared	Not declared	Not declared
`watchlist`The brands saved on your key's watchlist (page_id, name, shop, date added). Free.	The brands saved on your key's watchlist (page_id, name, shop, date added). Free.	Not declared	Not declared	Not declared	Not declared
`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 brand that changed; 0 if none did.	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 brand that changed; 0 if none did.	Not declared	Not declared	Not declared	Not declared
`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.	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.	Not declared	Not declared	Not declared	Not declared
`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 (5 credits per brand with something new). Without arguments: shows the webhook and its recent deliveries. Free to set.	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 (5 credits per brand with something new). Without arguments: shows the webhook and its recent deliveries. Free to set.	Not declared	Not declared	Not declared	Not declared

Details

Registry status: Active
Published: Nov 13, 2026
Updated: Nov 13, 2026
Website: https://askposeidon.app/⁠ (opens in a new tab)
Repository: Not given
Categories (suggested): Marketing and SEOSuggested categories are assigned automatically from the registry text and may be wrong. Verified operators can correct them.
GDPR: Not declared

Are you the operator? Claim this listing