Skip to content
DER.run
Open studio
Opened from AIdolBack

Use DER from your AI agent

Connect Claude Code, Cursor, VS Code, Codex or any MCP client to DER, then ask in plain words. Same models and the same credits as the studio.

Pick your AI app

Add DER to Claude Code

Run this once in your terminal. Just the address — no API key.

Terminal
claude mcp add --transport http der https://api.der.run/mcp

Sign in when Claude Code asks

Claude Code marks DER as needing sign-in but doesn't open it by itself. In Claude Code, run /mcp, pick der and choose Authenticate.

In Claude Code
/mcp

A DER.run page opens. Check which app it is and which account you're signed in with, then click Allow.

You can disconnect it any time in Account › Connected apps.

Try it

Copy one into your app
Start with this“Use DER to create an AIdol named Hana, a street dancer with silver hair — tell me the price first.”

Ask for an AIdol

  • “Use DER to create an AIdol named Hana: a street dancer with silver hair, half-body portrait.”
  • “Use DER to make three new looks of Hana with this photo for her face: studio, street and beach.”
  • “Use DER to make a full-body 9:16 shot of Hana for my story.”

Use DER to create an AIdol named Hana: a street dancer with silver hair, half-body portrait.

der · der_create_job(model: "character-image", params: {mode: "preset", name: "Hana", framing: "half_body", aspect_ratio: "3:4", appearance_details: "…"})

Hana is ready · Half body · 3:4der_get_results · kept 7 days

Tools your agent gets

MCP
  • der_list_modelsModels, prices and limits
  • der_quotePrice a job before it runs (free)
  • der_create_jobCreate an AIdol or shoot new photos of one
  • der_get_jobStatus and result links
  • der_get_resultsDownload links · kept 7 days
  • der_list_charactersYour AIdols, to make new photos of them
+ 11 more
  • der_describe_modelEvery setting and input of one model
  • der_list_jobsYour jobs, newest first
  • der_cancel_jobCancel a job that is still queued
  • der_balanceYour credits and tier
  • der_list_profilesYour trained voices and avatars
  • der_upload_assetUpload a small file, up to 6 MB
  • der_begin_uploadStart uploading a larger file
  • der_complete_uploadFinish a larger upload
  • der_list_avatarsSystem avatars for narration
  • der_import_videoThe video behind a Douyin or TikTok link
  • der_recognize_lyricsThe lyrics of a song (1 credit)

https://api.der.run/mcp

DER skill

A skill package that teaches your agent how to use DER well.

Download der.zip

https://api.der.run/v1/skills/der.zip