# Poseidon

> Poseidon is a freemium MCP server for marketing and seo. Find which Meta ad formats, hooks and scripts win, using EU reach data, pay per search. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://askposeidon.app
- **MCP Registry name:** app.askposeidon/poseidon
- **Categories:** marketing and SEO
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.askposeidon.app/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "poseidon": {
      "url": "https://api.askposeidon.app/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [Red Center Studio free tools](https://ai-powered.com/mcp/red-center-studio-free-tools): Red Center Studio free tools is a free MCP server for marketing and seo.
- [ASOScan](https://ai-powered.com/mcp/asoscan): ASOScan is an MCP server for marketing and seo.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.
- [Daniels AI Design Studio](https://ai-powered.com/mcp/daniels-ai-design-studio): Daniels AI Design Studio is an MCP server for design and media.

---
Source: https://ai-powered.com/mcp/poseidon
