MCP

Seedance MCP server: create videos and images in your AI assistant

Connect your Seedance 3.0 AI account to an AI assistant through the Model Context Protocol (MCP). Describe what you need in a conversation; the assistant quotes the credit cost, submits the generation after you confirm and returns the result.

How it works

  1. 1

    Add the server URL

    Add the MCP server URL above in the connector or MCP settings of your AI assistant.

    MCP server URL

    https://www.seedances3.com/api/mcp
  2. 2

    Sign in and authorize

    Sign in to your Seedance 3.0 AI account and allow access. No API key is required.

  3. 3

    Describe your request

    Ask for a video or an image in the conversation. The assistant states the credit cost before it generates and asks you first when a generation is expensive.

Connection steps by client

Menu names may differ slightly between client versions.

Claude (web and desktop)

Free plans allow one custom connector. On Team and Enterprise plans, an owner first adds the connector in Organization settings > Connectors.

  1. 1Open Customize > Connectors, select + Add and choose Add custom connector.
  2. 2Enter a name, such as Seedance 3.0 AI, paste the MCP server URL and select Add.
  3. 3Select Connect, sign in to your Seedance 3.0 AI account and allow access.
  4. 4In a conversation, select + in the lower left, open Connectors and turn on the connector.

ChatGPT

Adding custom MCP servers is subject to your account and workspace policies.

  1. 1Open the Plugins page (chatgpt.com/plugins), select + and choose Add custom MCP server.
  2. 2Enter a name and a description, paste the MCP server URL under Connection and choose OAuth for authentication.
  3. 3Review the risk notice, select Create as a plugin, then sign in to your Seedance 3.0 AI account and allow access.
  4. 4In a conversation, type @ and select the plugin before making your request.

Gemini

Custom apps require access to Gemini Spark, an age of 18 or over, a location in the United States and Keep Activity turned on. Google currently supports them in English only.

  1. 1Open Settings and select Connected Apps. In some versions, Connected Apps is located under Personal intelligence.
  2. 2Under the custom apps for Spark, paste the MCP server URL and select Next.
  3. 3Sign in to your Seedance 3.0 AI account and allow access.
  4. 4Switch to Spark, type @ and choose the app before making your request.

Claude Code

  1. 1Run the following command in a terminal to add the server.
  2. 2In Claude Code, run /mcp, select seedances3 and complete the sign-in.
claude mcp add --transport http seedances3 https://www.seedances3.com/api/mcp

Codex

In the Codex app, open Settings > Plugins > MCPs, select Add and choose Add MCP server. Select Streamable HTTP, paste the MCP server URL and save, then sign in to your Seedance 3.0 AI account when prompted. The steps below are for the command line.

  1. 1Run the following command in a terminal to add the server.
  2. 2Sign in and allow access in the browser window that opens.
codex mcp add seedances3 --url https://www.seedances3.com/api/mcp

OpenCode

  1. 1Add the configuration below to opencode.json in your project folder.
  2. 2Run the command below in a terminal.
  3. 3Sign in and allow access in the browser window that opens.
{"mcp":{"seedances3":{"type":"remote","url":"https://www.seedances3.com/api/mcp"}}}
opencode mcp auth seedances3

Other clients (API key)

  1. 1Use this method only when a client cannot sign in through OAuth.
  2. 2Create an API key on the API page and send it as a Bearer token together with the MCP server URL.
  3. 3Store the key in the secure credential settings of the client. Do not paste it into a conversation.
https://www.seedances3.com/api/mcp
Authorization: Bearer sk_live_…

Let a coding agent complete the setup

Send the following instruction to Claude Code or Codex. The agent reads the setup guide and adds the server for you.

Read https://www.seedances3.com/mcp-guide.txt and connect the Seedance 3.0 AI MCP server (https://www.seedances3.com/api/mcp) to this client.

Available models

Each model offers the same options as on the website and in the API.

  • Seedance 2.5
    Video
    Text, image or reference media to video; 4 to 30 seconds, up to 2K, with sound. Requires a previous purchase.
  • Seedance 2
    Video
    Text, image or reference media to video; 4 to 15 seconds, in the Mini, Fast and Pro quality tiers.
  • Kling 4.0
    Video
    Text, reference media or keyframes to video; 3 to 30 seconds, at 720p or 1080p.
  • Video Upscale
    Video
    Upscales an existing video of up to 10 minutes to 720p, 1080p, 2K or 4K, in the Standard, Pro and Ultimate tiers.
  • GPT Image 2.5
    Image
    Text-to-image generation and image editing.
  • GPT Image 2
    Image
    Text-to-image generation and image editing, with up to four images per request.
  • Nano Banana Pro
    Image
    Text-to-image generation and image editing at up to 4K.
  • Nano Banana 2
    Image
    Text-to-image generation and image editing at up to 4K, with optional search grounding.
  • Nano Banana 2 Lite
    Image
    Text-to-image generation and image editing at 1K, at the lowest cost.
  • Seedream 5 Pro
    Image
    Text-to-image generation and image editing at 1K or 2K.
  • Seedream 5 Lite
    Image
    Text-to-image generation and image editing at 2K or 4K.
  • Image Upscale
    Image
    Upscales an existing image to about 2K, 4K or 8K and keeps its aspect ratio.

Credits and billing

  • Connecting, checking your balance, requesting a quote and checking task status are free of charge.
  • Credits are deducted only when a generation is submitted, from the same personal balance used on the website and in the API.
  • Failed generations are refunded automatically.
  • When the video duration is set to auto, the maximum duration is reserved, and unused credits are refunded after generation.
  • Your AI assistant subscription is billed separately from Seedance 3.0 AI credits.

Example requests

After connecting, send one of these requests to your AI assistant.

  • Which video and image models can I use through Seedance 3.0 AI, and how many credits do I have?
  • Quote a 5-second 16:9 Seedance 2.0 video in the Fast tier: a paper boat drifting down a rainy street at dusk.
  • Create a 2K square poster for a mountain music festival with Nano Banana Pro. Tell me the credit cost first.
  • Turn this landscape photo into a 6-second Seedance 2.5 video with slowly drifting clouds: https://example.com/landscape.jpg
  • Check the status of my most recent task and send me the result link once it is ready.

Frequently asked questions

The connection succeeded, but the tools are unavailable. What should I do?

Confirm that the sign-in was completed and that the connector is enabled in the current conversation: in Claude, through + > Connectors; in ChatGPT, by typing @ and selecting the plugin. If the tools still do not appear, start a new conversation or reconnect.

Do I need an API key?

Not for clients that support sign-in through OAuth, such as Claude, ChatGPT, Gemini, Claude Code and Codex. An API key is needed only for clients without OAuth support.

How do I disconnect an AI assistant?

On the API page, select Disconnect next to the app under Connected AI apps. Access ends immediately. To use the app again, connect it and allow access once more; it then appears as a new connection.

Why are earlier tasks missing from the task list after I reconnected?

Each connection lists only the tasks it created. Tasks from an earlier connection remain listed under Recent API tasks on the API page, which shows your latest tasks from the past 30 days.

Can I use images or videos stored on my computer?

Yes, in AI apps that run on your computer, such as Claude Code, Codex, Cursor and OpenCode: the app uploads the file for you before generating. Chat apps such as Claude, ChatGPT and Gemini cannot access files on your computer, so with them the file must be available at a public HTTPS URL. Upload the file to a service that provides a direct link, then include that link in your request.

Which credits are used?

Your personal credit balance, which is also used on the website and in the API. Team credits are not used.

Is there a Seedance 2.5 MCP server?

Yes. The same MCP server provides both Seedance 2.5 and Seedance 2.0; name the model in your request. Seedance 2.5 requires an account with a previous purchase.

Ready to connect?

Copy the MCP server URL and add it to your AI assistant. You can manage connected apps on the API page at any time.

Go to the API page