Duchamp MCP server

Duchamp — ad research for coding agents

Duchamp is an ad-research tool for Claude Code, Codex, and Cursor. It finds the ads curated advertisers have kept running for 90+ days, and you save, compare, and pull the research materials into your agent, on the web or over one remote MCP server: https://duchamp.app/api/mcp.

Call searchads first, then getad or getbrandanatomy. Creative files, ad copy, keyframes, and transcripts need the signed-in account. Lists and counts on the site are public. A reference prompt from composetransferbrief is a reference. It does not promise the same look or the same outcome. The original ad stays a link (duchampurl). getad returns timestamped keyframes, the speech transcript, full body copy, the landing URL, and observed numbers, plus a stored AI analysis when one exists (format, hook, 15 emotional drivers, persona, creative targeting, product category, first product appearance — filled by a nightly batch, Foreplay-style). Treat the analysis as a reference and check it against the materials; searchads can filter by its fields. Product facts passed to composetransfer_brief are not stored. Saved items, boards, and watched advertiser pages are stored for the signed-in user. Those tools need a separate per-app opt-in on duchamp.app/saved/connect.

38 tools are registered: 26 ad-research tools, 6 Performance tools, 2 label tools, and 4 marketing workspace tools. The table below is that set.

Performance (your own Meta ad accounts, read only): connect an ad account on duchamp.app/performance, group accounts into workspaces (one per client or brand), then allow the app on duchamp.app/performance/connect. listworkspaces → getperformanceinsights with a workspaceid or accountids (group by ad name, copy, creative, landing page, headline, campaign, ad set, account, workspace or Audience Segment — New Audience, Engaged Audience, Existing Customer, sorted by the workspace's campaign-name rules or Duchamp's defaults; by a Meta breakdown at account level — country, age, gender, platform, placement, Meta customer segment; or compare rule groups) → getperformancetimeseries / getperformancecreative / getperformancead. Scores (hook, watch, click, convert, viral) are percentiles among every ad (or group) of the workspace in the same period — they are not an industry benchmark. Numbers use the ad set attribution setting and impression-time reporting unless you pick a window with attrclick (1d, 7d, 28d) and attrview (none, 1d) — Meta no longer returns 7-day or 28-day view. Besides spend, ROAS, CPA, CTR and video rates there are website and Shop purchases, landing page views, add to cart, checkout, leads, drop-off rates and your custom conversions (cctotal, value, cost, roas, listed by getperformancemetrics with a workspaceid).

Team boards (read only): listboards with scope: "team" or "all" adds the team's boards (marked scope: "team"); pass boardscope: "team" to getboard, exportboard and composetransferbrief, and use list_saved with scope: "team" for teammates' shared ads. This needs a separate team access per app on duchamp.app/saved/connect, and only teammates who turned on AI sharing appear — no notes, saved titles, link items or comments.

• Website: duchamp.app · English overview: duchamp.app/en
• Connect page: duchamp.app/mcp
• MCP endpoint: https://duchamp.app/api/mcp (Streamable HTTP, OAuth 2.1 with a free Duchamp account, no API key)
• For AI readers: llms.txt · llms-full.txt

What you get

Shortened. The full README is on GitHub.