search_app_advertiser
Search advertisers
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.
namerequiredtypes
app.recaoPublished by recao.appOfficial publisherv1.0.0Updated Nov 2, 2026
Rank a competitor's EU App Store ads by longevity. From Apple's official Ad Repository.
Recao lets an assistant look up competitors' EU App Store ads from Apple's Ad Repository, ranked by how long each ad has run, plus UGC ad generation and GTM…
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/app.recao%2Frecao-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"recao": {
"type": "http",
"url": "https://recao.app/api/mcp"
}
}
}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.
Any MCP client that speaks streamable HTTP can connect to https://recao.app/api/mcp. No auth during early access.
Numbers depend on live data; run the query to see current results.
Free (weekly report), Indie €29/mo, Pro €79/mo. Live MCP querying is included on Indie and Pro. See recao.app for current terms.
https://recao.app/api/mcpMIT. 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.
Source: README.md at commit 28bee4a
Search advertisers
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.
namerequiredtypesGet 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).
idrequiredtypecountriesdatePresetGet 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.
adIdrequireddatePresetGet playbook
Get a Recao GTM playbook: the go-to-market moves a solo app founder's agent runs, wired to the competitor data tools. Start with 'the-roadmap' (diagnoses the founder's stage and its binding constraint, then routes you to the right playbook). Call with no slug to list all playbooks.
slugSign up
Request a free Recao account for your human. This does NOT create an active account: it registers a PENDING one and emails your human an activation link; nothing works and no terms are accepted until they click it (the human accepts the terms at activation, not you). The API key in the response stays inert until then. Consent stays with the human, so calling this is a request, not a decision made for them: in an interactive session their approval of this tool call is the go-ahead; if you run autonomously, surface this step to your human instead of calling it. After activation, reconnect with header `Authorization: Bearer <key>`.
emailrequiredapp_nameUpgrade plan
Get the checkout link to upgrade this account to a paid plan (Indie €29/mo: 10 competitors + weekly auto-reports; Pro €79/mo: 25 competitors, new channels first, full API). Payment happens in the browser. Hand the link to the human.
planrequiredMemory index
List this account's company memory, one line per entry (name + description), newest first. Traverse index-first: scan this, then memory_recall(name) for full bodies. Memory accrues automatically from your competitor scans (exhaust) and from your own memory_note writes.
Takes no parameters.
Memory recall
Read one memory entry's full body by name (get names from memory_index).
namerequiredMemory note
Write (or update) a memory entry on this account: decisions, campaign outcomes, learnings. Use a short kebab-case name and a one-line description (that's the index line); details go in body. Your future sessions and Recao's weekly reports read this.
bodyrequirednamerequireddescriptionrequiredRoadmap status
Where the founder's agent starts its go-to-market work: diagnose which stage of the Recao Roadmap this account is in (S0 pre-launch to S4 scale), the binding constraint, and the playbook to run. Reads your scans and memory. Sharpen it: write a memory_note named 'company-stage' with your MRR band and funnel numbers, and this tool will use it.
Takes no parameters.
Generate avatar
Generate a UGC persona: your agent passes a persona brief (physical look plus vibe of one invented creator), and we return stills of that invented person plus an avatar_id. The persona brief anchors the same character in generate_clips takes, and the stills are the customer's reference artifact for the creative. Ask for up to 3; the default model returns a single strong base still, imagen and flux return the full set. Metered per generation; the price is shown in the response. Paid plans only.
countmodelpersona_briefrequiredGenerate clips
Render UGC video scenes as ad-ready clips, metered per second of video (the estimate shows the exact price before anything renders). Pass 3 to 6 scenes (5 to 8 seconds each, one action per scene, spoken lines at most 20 words; empty spoken_line for silent characters). Consecutive scenes pack into single TAKES of up to 15 seconds, one generation each. HOW CHARACTER IDENTITY WORKS, read carefully: all characters are described in TEXT (avatar_id resolves to its persona brief; or write the persona field yourself, covering one character or a whole ensemble). The video model rejects every image that contains a person, so no photo can anchor a face. Text keeps a character IDENTICAL only WITHIN a take; ACROSS takes it preserves the look and styling but the exact face can drift, and neither avatar_id nor persona prevents that. Structure your script so scenes where the same character must be recognizably identical sit adjacent and fit one take (15s or less); treat cross-take appearances as different shots of a matching character, and review the result. reference_image_urls (up to 9 https images) keeps real products or props on-model in every take; these images must contain no people. Without confirm, it validates the contract and returns the per-scene price estimate in EUR, and makes nothing. With confirm=true it starts the metered render and returns a job_id: rendering runs in the background over a few minutes, so poll clips_status with that id to get per-scene clip URLs plus the uncut takes. Paid plans only.
modelaspectscenesrequiredconfirmpersonaavatar_idreference_image_urlsClips status
Check a generate_clips render job by its job_id. Returns the status (processing, done, or error). When done, returns the finished clip URLs, the model used, and the booked cost in EUR. When it errored, returns the reason. Only jobs on your own account are visible.
job_idrequiredAssemble video
Stitch rendered scene clips into one ad-ready MP4 with burned-in subtitles and crossfades. Pass 1 to 6 clips in order, each with its mp4 url, its duration in seconds (3 to 12), and an optional subtitle line to burn over that clip. Every clip is scaled and padded to the chosen aspect (9:16 default 1080x1920, 1:1 1080x1080, or 16:9 1920x1080). Optional intro and outro title cards: pass intro/outro as { text, duration_s? } to bookend the ad with a centred title card (1 to 5 seconds, default 2) that crossfades into the video; cards do not count toward the 6-clip limit. Assembly is our compute, so it carries a small flat fee (about 0.12 EUR), booked only when the file is produced, against your trust cap. Runs in the background over up to a couple of minutes and returns a job_id: poll assemble_status with it to get the finished MP4 url. Feed it the clips from clips_status (map each to url, duration_s, subtitle). Paid plans only.
clipsrequiredintrooutroaspectAssemble status
Check an assemble_video job by its job_id. Returns the status (processing, done, or error). When done, returns the final MP4 url, the aspect, clip count, total duration, and the booked cost in EUR. When it errored, returns the reason. Only jobs on your own account are visible.
job_idrequiredUsage this period
Show this account's metered generation spend this period and its billing position: the usage cap, what has accrued toward it, and whether generation is waiting on a payment. Use it to report costs back to your human.
Takes no parameters.
Who am I
Show the authenticated account (plan, email, verification state), or confirm you're anonymous.
Takes no parameters.
100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
claude mcp add --transport http recao https://recao.app/api/mcp> 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.