Recao

Official4 tools

by fernando-menendez

Rank a competitor's EU App Store ads by longevity. From Apple's official Ad Repository.

Captured live from the server via tools/list.

search_app_advertiser

Search the Apple Ad Repository for apps or developers advertising on the EU App Store. Returns ids to use with get_competitor_ads. Start here with your competitor's app name.

Parameters2

name	string	required	App or developer name to search for
types	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 2,
      "description": "App or developer name to search for"
    },
    "types": {
      "type": "string",
      "enum": [
        "APP",
        "DEVELOPER"
      ]
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_competitor_ads

Get all Apple App Store ads a competitor has run (EU storefronts, up to 1 year back), with creative copy, placements, formats, and an inferred winner analysis: ads sorted by how long they've been running (longevity = the advertiser keeps paying = likely converting). Source: official Apple Ad Repository (DSA transparency data).

Parameters4

id	number	required	appId or developerId from search_app_advertiser
type	string	optional
countries	array	optional	EU country codes to filter (default: all 25). Available: AT,BE,BG,HR,CY,CZ,DK,EE,FI,FR,DE,GR,HU,IE,IT,LV,LU,NL,PL,PT,RO,SK,SI,ES,SE
datePreset	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "number",
      "description": "appId or developerId from search_app_advertiser"
    },
    "type": {
      "type": "string",
      "enum": [
        "APP",
        "DEVELOPER"
      ],
      "default": "APP"
    },
    "countries": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 2,
        "maxLength": 2
      },
      "description": "EU country codes to filter (default: all 25). Available: AT,BE,BG,HR,CY,CZ,DK,EE,FI,FR,DE,GR,HU,IE,IT,LV,LU,NL,PL,PT,RO,SK,SI,ES,SE"
    },
    "datePreset": {
      "type": "string",
      "enum": [
        "LAST_90_DAYS",
        "LAST_180_DAYS",
        "LAST_YEAR"
      ],
      "default": "LAST_YEAR"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_ad_details

Get full details and locale/creative variations for one specific ad (use adId from get_competitor_ads). Shows every language variant, creative asset URLs, and icon variations — useful to see how a competitor localizes a winning ad.

Parameters2

adId	string	required
datePreset	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "adId": {
      "type": "string"
    },
    "datePreset": {
      "type": "string",
      "enum": [
        "LAST_90_DAYS",
        "LAST_180_DAYS",
        "LAST_YEAR"
      ],
      "default": "LAST_YEAR"
    }
  },
  "required": [
    "adId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_playbook

Get a Recao platform playbook: opinionated, step-by-step ad strategy for indie apps, wired to the competitor data tools. Call with no slug to list available playbooks.

Parameters1

slug

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md4 KBView on GitHub

Recao MCP

MCP Transport Data

Query your competitors' App Store ads from inside Claude Code.

Recao is a weekly competitor-ad report for app developers. You paste your app once at recao.app, and every week you get the ads your competitors are running on the EU App Store: the creative copy, the placements, the formats, and how long each ad has stayed live. This repository documents the hosted MCP server that Indie and Pro users point their MCP client at to ask the same questions live, between reports.

The product source is not in this repo. This is the manifest and docs for the hosted remote endpoint.

Install

bash

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

Any MCP client that speaks streamable HTTP can connect to https://recao.app/api/mcp. No auth during early access.

Tools

Tool	What it does
`search_app_advertiser`	Find an app or developer in Apple's Ad Repository by name. Returns the ids the other tools take. Start here.
`get_competitor_ads`	Pull every App Store ad an advertiser ran in the EU (up to 1 year back), sorted by how long each has been live. An ad the advertiser keeps paying for is the closest public signal that it converts.
`get_ad_details`	Full detail for one ad: every locale variant, creative asset URLs, icon variations, placements, and date range. Shows how a competitor localizes a winning ad.
`get_playbook`	An Apple Search Ads playbook for indie apps, wired to the data tools. Call with no argument to list the available playbooks.

Example

code

> Which ads has Fabulous kept running the longest in the EU?

  search_app_advertiser "fabulous"  → Fabulous: Daily Habit Tracker
  get_competitor_ads (APP, LAST_YEAR)

  Longest-running creatives first:
  1. "Healthy Routines & Motivation" — search results,
     16 storefronts, live 365+ days
  2. "Santé Mentale & Motivation" — FR only, live 365+ days
     (a mental-health angle running only in France)

  One angle funded for over a year across 16 countries.
  France runs a different first line — a live localization
  test you can read for free.

> Show me every locale variant of creative #1

  get_ad_details

  The German variant leads on data privacy, the Spanish one
  on prediction accuracy. Same placement, same format,
  different opening line.

Numbers depend on live data; run the query to see current results.

Data source and legality

Source: Apple's official Ad Repository, published under Article 39 of the EU Digital Services Act. Public, free, no auth. Recao adds search, normalization, longevity ranking, and the MCP interface on top.
Coverage: 25 EU storefronts (the DSA's scope), roughly 1 year of rolling history, about a 7-day publication lag.
No keywords, bids, or spend. No legal source publishes competitor keywords, bids, or spend. Tools that show those numbers are estimating them. Recao reports only what is measurable: the creatives and how long each has run.
Channels: Apple App Store is live today. Meta is in setup and uses the equivalent EU ad transparency data.

Pricing

Free (weekly report), Indie €29/mo, Pro €79/mo. Live MCP querying is included on Indie and Pro. See recao.app for current terms.

License

MIT. See LICENSE. This repo covers the server manifest, schema, and examples. The underlying ad data belongs to Apple's public Ad Repository and its terms.

Install

Tools (4)

search_app_advertiserget_competitor_adsget_ad_detailsget_playbook

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://recao.app/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "recao-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://recao.app/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

search_app_advertiser

get_competitor_ads

get_ad_details

get_playbook

Recao MCP

Install

Tools

Example

Data source and legality

Pricing

Links

License

Install

Remote endpoint