MP-facing HTML Brief

MP Media MCP Video Endpoint Audit

MP Media MCP Video Endpoint Audit

Audit date: July 29, 2026

Status: Complete, corrected, deployed, and verified

Cloudflare Worker version: c21d4207-0d42-47dd-b08a-30ba339e2eb3

Executive summary

The MP Media MCP video registry and its endpoint routing were checked against current KIE.ai documentation and WaveSpeedAI's live model catalog.

  • 124 curated video routes audited
  • 124 valid after update
  • 0 unresolved endpoint discrepancies
  • 77 KIE routes checked against their current official documentation pages
  • 47 WaveSpeed routes checked against the live catalog
  • 945 WaveSpeed catalog models enumerated; generic passthrough continues to support models beyond the curated set
  • TypeScript compilation and Cloudflare deployment checks passed
  • Live registry verification passed
  • No generation jobs were submitted and no provider credits were consumed

What was checked

The audit validated each curated video entry for:

1. Exact provider model identifier

2. Correct submission endpoint family

3. Correct result/status endpoint family

4. Current documentation availability

5. Live WaveSpeed catalog presence and active status

6. MCP capability classification

7. Grouped-tool and registered-model dispatch behavior

8. Polling support for asynchronous direct APIs

The audit is repeatable through:

cloudflare-deployments/mp-media-mcp/scripts/audit-video-models.mjs

Endpoint families verified

KIE Market video models

  • Submit: POST /api/v1/jobs/createTask
  • Status/result: GET /api/v1/jobs/recordInfo?taskId={taskId}
  • Verified for all KIE Market-based text-to-video, image-to-video, avatar, edit, transition, extend, upscale, lip-sync, and utility routes.

KIE Veo

  • Submit: POST /api/v1/veo/generate
  • Status/result: GET /api/v1/veo/record-info?taskId={taskId}
  • Verified model selectors: veo3, veo3_fast, and veo3_lite.

KIE Runway

  • Generate: POST /api/v1/runway/generate
  • Extend: POST /api/v1/runway/extend
  • Status/result: GET /api/v1/runway/record-detail?taskId={taskId}

KIE Runway Aleph

  • Submit: POST /api/v1/aleph/generate
  • Status/result: GET /api/v1/aleph/record-info?taskId={taskId}

KIE Gemini Omni

  • Gemini Omni Video remains a KIE Market task: POST /api/v1/jobs/createTask
  • Gemini Omni Audio: POST /api/v1/omni/audio/create
  • Gemini Omni Character: POST /api/v1/omni/character/create

The audio and character direct routes are not counted in the 124-video-route total, but their routing remains correct following the preceding Omni repair.

WaveSpeedAI

  • Submit: POST /api/v3/{model}
  • Result: GET /api/v3/predictions/{id}/result
  • All 47 curated video model paths matched exact active entries in the live 945-model catalog.

Documentation drift found and corrected

All 109 previously curated video routes were already correct. The deep documentation comparison found 14 current KIE routes that were documented but not yet curated:

  • kie.bytedance.seedance-2-mini
  • kie.wan.2-2-a14b-speech-to-video-turbo
  • kie.pixverse-v6.text-to-video
  • kie.pixverse-v6.image-to-video
  • kie.pixverse-v6.transition
  • kie.pixverse-v6.extend
  • kie.pixverse-v6.reference-to-video
  • kie.omnihuman-1-5
  • kie.omnihuman-1-5.human-identification
  • kie.omnihuman-1-5.subject-detection
  • kie.volcengine.video-to-video-lip-sync
  • kie.runway.generate
  • kie.runway.extend
  • kie.runway.aleph

One existing route was also corrected from an audio classification to its actual video-avatar capability:

  • kie.infinitalk.from-audio → video.avatar

MCP implementation updates

  • Added first-class Runway generate, extend, and status handling.
  • Added first-class Aleph generate and status handling.
  • Added kie_get_runway_task for manual polling when wait: false.
  • Added kie_get_aleph_task for manual polling when wait: false.
  • Updated kie_video_generate to route KIE Market, Veo, Runway, Aleph, and supported direct families automatically.
  • Updated run_registered_model to select the correct endpoint family for the new routes.
  • Added video.avatar to KIE video discovery and grouped execution.

Final inventory

  • Video generation: 41
  • Image-to-video: 56
  • Video upscale: 2
  • Video extend: 6
  • Video edit: 13
  • Video avatar: 6
  • Total: 124

By provider:

  • KIE.ai: 77
  • WaveSpeedAI: 47

Verification results

  • Documentation/catalog audit: 124 passed, 0 review
  • KIE: 77 passed, 0 review
  • WaveSpeed: 47 passed, 0 review
  • TypeScript: passed
  • Cloudflare dry run: passed
  • Production deployment: passed
  • Live registry checks: passed
  • Paid generation tests: not run intentionally

The no-spend validation proves that the registry identifiers, documented endpoints, dispatch logic, compilation, deployment, and live discovery are correct. A paid end-to-end generation was intentionally avoided because it was not necessary to validate endpoint routing and would consume credits.

Ongoing maintenance

The new audit script should be run whenever KIE or WaveSpeed announces model changes. It makes endpoint drift visible by comparing the local registry against official KIE documentation and the complete live WaveSpeed catalog.