# MCP and skills

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

## 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.

```bash
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

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

1. [llms.txt](https://diffusr.ai/docs/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](https://diffusr.ai/docs/quickstart) and [Errors](https://diffusr.ai/docs/errors).

Source: https://diffusr.ai/docs/mcp-and-skills