Skip to content
Book a callStart free

Let your agent use diffusr

Connect the diffusr MCP server, and install the skills that teach an agent to price first and ask before spending.

View as Markdown

Connect the MCP server

Section titled “Connect the MCP server”

The server is at https://app.diffusr.ai/api/mcp. It signs in with OAuth when you add it by URL, or accepts an API key as Authorization: Bearer <key>. A test key works too, and costs nothing.

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

Other clients: add a remote MCP server with that URL.

The tools have the same names and the same JSON as the REST routes: make_video, make_image, edit_image, recast, make_music, creator_video, run_template, get_result, list_results, upload_asset, list_models, list_templates. Every one that makes something takes dry_run: true.

Video templates (animation looks, UGC talking head, podcast) are also MCP prompts and resources (diffusr://templates/...): step-by-step recipes that use the tools above.

Skills

Section titled “Skills”

The agent kit teaches an agent to do it the right way: price first, ask before spending, pick the right tool.

Skill Use it to
diffusr Connect, test vs live keys, dry run and price first, polling vs callbacks, uploads, errors, run_template vs recipes
ugc-talking-head One or two people saying a script to a phone camera
two-host-podcast Two hosts in a studio, one take up to 30 s
product-ad A 20 to 30 s UGC product ad from a product photo
recast The same clip, a new cast or place
animation-looks A film in an animated look (claymation, LEGO, …)
seedance-references Make and pass reference pictures and voice clips

Install:

  • Claude Code plugin: after launch, add the diffusr plugin from its marketplace; it adds the skills and the MCP server together. Until then, add the MCP server as above and copy the skills.
  • Codex and other AGENTS.md readers: copy AGENTS.md into your project and the skills/ folders where your agent reads skills.
  • Cursor: copy diffusr.mdc into .cursor/rules/ and add the MCP server URL in Cursor’s MCP settings.
  • Any agent that reads Agent Skills (a folder with a SKILL.md): copy the folders.

What an agent should read first

Section titled “What an agent should read first”
  1. llms.txt, then the pages it links (each is plain Markdown).
  2. The OpenAPI spec: https://app.diffusr.ai/api/v2/openapi.json
  3. Quickstart and Errors.