mcp.film

mcp.film / Video Generation / Ark Seed Multimodal MCP

Ark Seed Multimodal MCP

Communityby BytePlus SA program (byteplus-sa) — vendor-adjacent, not the ModelArk product teampaidverified Sep 16, 2026

Seedance video, Seedream stills, and Seed Audio behind one typed BytePlus MCP server.

What it does

A FastMCP server that fronts BytePlus ModelArk and Seed Speech: Seedance text- and image-to-video (including Seedance 2.5, which takes up to 30 reference images and 10 reference videos), Seedream image generation and editing, Seed Audio full-scene speech, ASR, video understanding, and the VOD AI MediaKit tools for enhancement, transcode, subtitle burn-in or removal, and voice/music/sfx separation. Every long job runs in the background — native MCP task augmentation where the client supports it, ordinary ark_job_* tools where it does not — and finished media is copied into a local artifact store, which matters because BytePlus output URLs expire after 2 hours for audio and 24 for image and video. The only route to Seedance in this directory, and the only one that also carries the finishing tools around it.

Connect

Connection is set up through the vendor's flow — follow the official connect instructions.

Local install: Clone and run locally — git clone https://github.com/byteplus-sa/ark-mcp, then uv sync, then point the client at: uv --directory /path/to/ark-mcp run python -m ark_mcp (BytePlus keys go in the client's env block). No npm or PyPI package exists.

Auth: api_key · env BYTEPLUS_MODELARK_API_KEY — https://console.byteplus.com — ModelArk > API Key covers Seedream and Seedance; Seed Speech and VOD AI MediaKit each issue a separate key, and the server only registers the tool groups whose keys you set

Sample tools

seedance_create_taskseedance_get_taskseedance_create_task_variationsseedream_generate_imageseedream_edit_imageseed_audio_generatespeech_to_textseed_understandvod_enhance_videovod_separate_audiomedia_uploadark_job_submit

Field notes

Read the vendor line carefully: byteplus-sa is BytePlus's solution-architect program org (created 16 May 2026, blog byteplus.com, four public repos), not the ModelArk product team, so this is listed as unofficial — the keys and the billing are first-party, the server is not. MIT by GitHub's licence detection, although the README's own licence section punts to 'project configuration'. It is young and unnoticed: 1 star, repo created 20 Jul 2026, last pushed 14 Sep 2026, no releases or tags and no published package, so a clone plus uv sync on Python 3.12+ is the only install and you get whatever main happens to be that day. Its own quality claims disagree with themselves — the feature list says 1,155 offline tests at 86% coverage, the status section says 631 at 88% — and we have not run it, so treat the polish as unverified. Three credentials, three auth schemes: ModelArk is Bearer, Seed Speech is X-Api-Key, VOD MediaKit is Bearer, and the default ModelArk host is region-scoped to ap-southeast, so accounts elsewhere must override BYTEPLUS_MODELARK_BASE_URL. The 3D tools (Hyper3D/Hitem3d) stay hidden unless you set BYTEPLUS_MODELARK_3D_ENABLED. The edge that will bite a filmmaker first: Seedance reference video must be a public HTTPS URL with no inline Base64 option, so you need TOS or S3 credentials for media_upload or your own hosting, and the server's SSRF policy rejects anything resolving to a private address. Model IDs are ModelArk endpoint strings you configure yourself (SEEDANCE_DEFAULT_MODEL, SEEDREAM_DEFAULT_MODEL), not friendly names.

Also in Video Generation

Pairs well with