Do I need an API key?

No. The first time a client connects, a browser opens and you sign in with a free Duchamp account and allow the connection (OAuth 2.1). There is no API key.

What counts toward the daily free limit?

get_template, get_ui and get_asset each count as one use against the same daily free allowance as copying on duchamp.app. Searches, get_reference, get_reference_label and the ads research tools are not counted, so search and inspect freely before fetching. Ads research does not return original creative files. The allowance resets at midnight KST, and items you already fetched today can be fetched again. Payments are not open yet, so the limit is currently off.

Does the server generate images or videos?

No. It returns references, prompts and recipes. Image generation happens in the AI tool you use; motion videos, logos and pitch decks are rendered with code by your coding agent.

Claude Code and Codex (one-line connect or plugin), Cursor through .cursor/mcp.json, and any app that supports remote MCP over Streamable HTTP with OAuth.

Duchamp for agents

Connect Duchamp to Claude Code, Codex or Cursor over MCP

One remote server for visual references and your marketing workspace. Your agent searches UI pages, image prompts, motion recipes, fonts and backgrounds, looks at the real preview, then fetches the recipe or prompt and builds with your brand. Sign in with a free Duchamp account; there is no API key.

Endpoint: https://duchamp.app/api/mcp
Transport: Streamable HTTP
Auth: OAuth 2.1, free account, no API key

Connect in one line

Finds Claude Code and Codex on your machine, registers Duchamp in both, and opens the browser login. Nothing to copy afterwards.

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

Manual setup

Claude Code. Run the command, then in a new session open /mcp, pick duchamp and choose Authenticate.
```
claude mcp add duchamp --scope user --transport http https://duchamp.app/api/mcp
```
Codex. Two commands. The second opens the browser login; start a new session afterwards.
```
codex mcp add duchamp --url https://duchamp.app/api/mcp
codex mcp login duchamp
```
Cursor. Put this in .cursor/mcp.json (or add the duchamp entry to an existing mcpServers), save, then press Connect next to duchamp in Cursor's MCP settings.
```
{
  "mcpServers": {
    "duchamp": {
      "url": "https://duchamp.app/api/mcp"
    }
  }
}
```
Any other MCP app. Add a remote server named Duchamp with the endpoint above, transport Streamable HTTP, authentication OAuth. Menus differ by app.

Plugin

The plugin registers the same server and adds a skill that teaches the agent the search → inspect → fetch flow and the four blanks. Source: github.com/duchamp-app/duchamp (MIT).

# 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

Twenty-five library tools

Search one group at a time, inspect the reference, then fetch. Only items listed on duchamp.app and already released are returned.

Tool	What it does	Ids	Counts toward daily limit
search_image_templates	Search image templates, carousel styles, motion videos, the logo kit and pitch decks by use, ratio, occasion or plain language.	image.<slug> · carousel.<slug> · video.<slug> · deck.<slug>	No
get_reference	Inspect one visual reference: example images or video URLs, frame positions, authored visual and motion rules, palettes.	any id from search_image_templates	No
get_template	Fetch the full prompt (image, carousel) or recipe (video, logo, pitch deck), ready to paste or run.	same ids	Yes
search_ui	Search finished landing pages and hero sections by service type, intent, style or a plain-language query.	ui.<slug> · ui.hero-<slug>	No
get_ui	Fetch one page or hero section: section order with reasons, conditional variants, style system, fonts, previews and the React + Tailwind recipe.	ui.<slug> · ui.hero-<slug>	Yes
search_assets	Search free commercial-use fonts (category, weights, Hangul coverage, license) and text-free motion background loops.	font.<slug> · background.<slug>	No
get_asset	Fetch one asset: font install code (web, npm, next/font, agent prompt) with its license, or MP4 download URLs for a background.	font.<slug> · background.<slug>	Yes
search_reference_labels	Search Duchamp's breakdown of market-tested ads. Original creative files are not included.	ref.meta_ad_library.<id>	No
get_reference_label	Fetch one reference label in full. Original creative files are not included. A research reference: Duchamp does not reproduce the ad.	ref.meta_ad_library.<id>	No
search_ads	Search observed ads. Returns days running, survival, rank and signed-in ad copy. No original creative files.	ad archive id	No
get_ad	Read one observed ad: facts, history, a label summary when one exists, and up to three other long-running ads from the same advertiser. No original creative files.	ad archive id	No
get_brand_anatomy	Read one advertiser page: mix, long-running ads, rankings, hooks and landings. No original creative files.	page id	No
compare_brands	Compare at most four advertiser pages. No impression counts and no revenue.	page id	No
list_watched_brands	List advertiser pages this user watches, including the page marked as their own.	page id	No
list_saved	List this user's saved ads, labels and https URLs.	saved item id	No
list_boards	List this user's boards.	board id	No
get_board	Read one board. Ad items include observation numbers and signed-in copy. Label items include a summary. No original creative files.	board id	No
watch_brand	Watch an advertiser page from its page id or advertiser-page URL. is_mine marks the user's own page.	page id	No
unwatch_brand	Stop watching an advertiser page.	page id	No
save_to_library	Save an ad, a reference label, or an https URL. Notes and tags stay on the item and are not written to the call log.	ad id · ref.<source>.<id> · https URL	No
create_board	Create a board in this user's library.	board id	No
add_to_board	Add saved item ids to a board.	board id · item id	No
compose_transfer_brief	Build a reference prompt from ads, labels, a page or a board plus facts you filled from the user's own context. A reference only, not a guaranteed reproduction. Those facts are not stored and not logged.	ad id · label id · page id · board id	No

Four marketing workspace tools

After connecting, open Marketing AI connections and choose read or read/write access for your client. Existing library consent does not grant access to private projects. Access covers all marketing projects in your account and can be revoked on that page.

list_marketing_projects lists summaries; get_marketing_project reads product facts, competitor observations, reference content, strategy and experiments. create_marketing_project and update_marketing_project save your work to the same workspace as the website. Updates require the latest version and replace changed nested fields in full. These tools do not run paid research APIs or publish content.

Account, limits and rules

Sign in with a free Duchamp account the first time a client connects. No API key, nothing to paste.
get_template, get_ui and get_asset share one daily free allowance with copying on duchamp.app. Searches, get_reference and ads research are not counted. Creator ($9 / month or $79 / year) removes the limit. Payments are not open yet, so the limit is currently off.
Templates have four blanks — brand name, brand color, topic, the words to show — and the agent fills them only with what you confirmed. It never invents brand facts, numbers, dates, prices or reviews. Pitch-deck numbers come only from you.
Image and carousel prompts are written in Korean; ask for the result in your language. UI recipes, video recipes, font code and backgrounds are code and files.

Example requests

Paste one into your agent after connecting.

A landing page for an AI tool

Use Duchamp. Search UI pages for an AI SaaS whose visitors need to understand the product first, in a clean style. Show me the top two with their section order, then fetch the one I pick and build it for my product — ask me the STEP 0 questions before writing code.

A launch poster image

Use Duchamp. Search image templates for a poster announcing a product launch, inspect the reference, then fetch the prompt and fill the four blanks with my brand name, brand color, topic and the words to show. Write the result in English.

A Korean web font with license

Use Duchamp. Search assets for a free Korean sans-serif with at least five weights, tell me its license, then fetch the asset and add it to this Next.js project with next/font.

Questions

Do I need an API key?: No. The first time a client connects, a browser opens and you sign in with a free Duchamp account and allow the connection (OAuth 2.1). There is no API key.
What counts toward the daily free limit?: get_template, get_ui and get_asset each count as one use against the same daily free allowance as copying on duchamp.app. Searches, get_reference, get_reference_label and the ads research tools are not counted, so search and inspect freely before fetching. Ads research does not return original creative files. The allowance resets at midnight KST, and items you already fetched today can be fetched again. Payments are not open yet, so the limit is currently off.
Does the server generate images or videos?: No. It returns references, prompts and recipes. Image generation happens in the AI tool you use; motion videos, logos and pitch decks are rendered with code by your coding agent.
Which clients work?: Claude Code and Codex (one-line connect or plugin), Cursor through .cursor/mcp.json, and any app that supports remote MCP over Streamable HTTP with OAuth.

Browse what the tools return: UI pages and hero sections, fonts, and the library overview.