Duchamp

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 search_ads first, then get_ad or get_brand_anatomy. Creative files, ad copy, keyframes, and transcripts need the signed-in account. Lists and counts on the site are public. A reference prompt from compose_transfer_brief is a reference. It does not promise the same look or the same outcome. The original ad stays a link (duchamp_url). get_ad 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; search_ads can filter by its fields. Product facts passed to compose_transfer_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. list_workspaces → get_performance_insights with a workspace_id or account_ids (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) → get_performance_timeseries / get_performance_creative / get_performance_ad. 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 attr_click (1d, 7d, 28d) and attr_view (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 (cc_ _total, _value, _cost, _roas, listed by get_performance_metrics with a workspace_id).

Team boards (read only): list_boards with scope: "team" or "all" adds the team's boards (marked scope: "team"); pass board_scope: "team" to get_board, export_board and compose_transfer_brief, 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

Do not invent numbers, dates, prices, or reviews. Transcripts are raw speech-to-text and can mishear names. A person should check what the agent concludes.

Connect in one line

sh -c "$(curl -fsSL https://duchamp.app/connect.sh)"

The script finds Claude Code and Codex, registers the server, and opens your browser to sign in with a free Duchamp account. There is no token to copy.

Manual setup

Claude Code

claude mcp add duchamp --scope user --transport http https://duchamp.app/api/mcp

Then in a new session run /mcp, choose duchamp and press Authenticate.

Codex

codex mcp add duchamp --url https://duchamp.app/api/mcp

codex mcp login duchamp

Cursor — add to .cursor/mcp.json, then press Connect next to duchamp in Cursor's MCP settings:

{

"mcpServers": { "duchamp": { "url": "https://duchamp.app/api/mcp" } } }

Any other MCP client — add a remote server named Duchamp with transport Streamable HTTP and URL https://duchamp.app/api/mcp. The first connection opens a browser for OAuth.

Plugin install (skills + agent)

The plugin adds eleven skills (nine active, two paused) and a judge agent on top of the MCP server.

Claude Code:

/plugin marketplace add duchamp-app/duchamp

/plugin install duchamp@duchamp

Codex:

codex plugin marketplace add duchamp-app/duchamp

codex plugin add duchamp@duchamp

Then sign in once: Claude Code /mcp → duchamp → Authenticate; Codex codex mcp login duchamp.

• ads-research: find working ads, open one ad with its materials, break down an advertiser, compare your page, and keep a saved library. This is the skill to use.
• Research skill packs — workflows the agent runs end to end. Say "use the skill on …":
• evergreen-hunt: ads that ran 90+ days in a niche, clustered by hook, with transcripts for the strongest.
• weekly-competitor-sweep: your watched advertisers' last 7 days as a Slack-ready Monday brief.
• creative-test-autopsy: what one advertiser is testing now vs what it keeps scaling.
• board-to-brief: a named board turned into a production brief with three angles grounded in the saved ads.
• hook-mining: a hook bank for a niche and format, ranked by how long the ads ran.
• domain-war-room: a competitor's domain turned into its ads, hooks, landing pages, paid partners and attack angles.
• angle-theft-detector: your winning creatives from Performance (your own Meta ad accounts) matched to lookalike ads from other advertisers, with how crowded each angle is.
• connect-extension: install and connect the Duchamp Chrome extension (opens the Chrome Web Store page in your Chrome, you click Add and Connect), then confirm the first save from the Meta Ad Library.
• make and launch-kit: paused. They call tools that are not registered. Do not call those tools. Use ads-research.
• visual-judge agent (Claude Code): a fresh-context reviewer. The make skill that used to call it is paused.

Everything runs on your own Claude Code or Codex subscription.

Tools

| get_collection_status | How fresh and deep the observations are per tracked page (last seen, days observed, days ranked, last attempt) and pages collected per day for 7 days. Chec