future-video-studio-mcp 0.1.2

MCP server for creating Future Video Studio renders through the FVS Agent API.

Future Video Studio MCP

Future Video Studio MCP lets agents create, monitor, cancel, and download cinematic AI video renders through the Future Video Studio Agent API.

The hosted MCP server is available at:

https://mcp.future.video/mcp

The same server can also run locally over stdio from this Python package.

Billing Paths

• Account mode: provide X-FVS-Agent-Key or FVS_AGENT_API_KEY. Renders charge the owning Future Video Studio account wallet under the same credit model and saved pipeline defaults as the web app.
• Pay-per-render mode: omit the account key. The server returns a Link/Stripe MPP payment quote, then exposes a claim-token status URL so the agent can retrieve the result.

Agents should get explicit user approval before submitting wallet-backed account renders.

Tools

• fvs_submit_render: submit a render request, optionally with uploaded files
• fvs_create_paid_render_quote: create a no-account Link payment quote
• fvs_get_render_status: check a render by project_id or status_url
• fvs_get_paid_render_status: check a paid render by status_url or quote_id plus claim_token
• fvs_cancel_render: cancel a render by project_id or cancel_url
• fvs_download_final_video: save a completed render from its signed URL
• fvs_example_render_request: return an example scene render payload

Downloading Final Renders

Use fvs_download_final_video only after fvs_get_render_status or fvs_get_paid_render_status returns a final_video_url for a completed render. If a signed URL has expired, call the relevant status tool again to refresh it.

The download tool:

• performs an unauthenticated HTTPS GET to the signed final_video_url
• writes the video bytes to output_path on the MCP server's local filesystem
• creates missing parent directories
• refuses to replace an existing file unless overwrite is true
• does not require FVS_AGENT_API_KEY
• does not spend wallet credits, create renders, cancel jobs, or modify remote state
• may take minutes for large videos and uses a 600 second request timeout

Parameters:

• final_video_url: an absolute HTTPS signed URL returned by a completed render status response. Do not pass arbitrary or untrusted URLs.
• output_path: a local path visible to the MCP server process, such as C:/Users/me/Videos/fvs-result.mp4 or /tmp/fvs-result.mp4.
• overwrite: defaults to false; set it to true only when replacing the destination file is intended.

Remote MCP Config

Account mode:

{
  "mcpServers": {
    "future-video-studio": {
      "url": "https://mcp.future.video/mcp",
      "headers": {
        "X-FVS-Agent-Key": "fvs_live_replace_me"
      }
    }
  }
}

Pay-per-render mode:

{
  "mcpServers": {
    "future-video-studio": {
      "url": "https://mcp.future.video/mcp"
    }
  }
}

Local Install

python -m pip install future-video-studio-mcp
python -m fvs_mcp_server

Example local stdio MCP config:

{
  "mcpServers": {
    "future-video-studio": {
      "command": "python",
      "args": ["-m", "fvs_mcp_server"],
      "env": {
        "FVS_AGENT_API_KEY": "fvs_live_replace_me",
        "FVS_AGENT_BASE_URL": "https://app.future.video"
      }
    }
  }
}

FVS_AGENT_API_KEY is optional. Leave it unset to use paid quote mode. FVS_AGENT_BASE_URL defaults to https://app.future.video.

Local Development

python -m pip install -e ".[dev]"
python -m pytest
python -m fvs_mcp_server

Run the HTTP transport locally:

$env:FVS_MCP_TRANSPORT = "streamable-http"
python -m fvs_mcp_server

Publishing

Build and check the package:

python -m build
python -m twine check dist/*

This package is intended to publish to PyPI as:

future-video-studio-mcp

The MCP Registry package verification marker is the hidden comment near the top of this README:

<!-- mcp-name: video.future/future-video-studio -->

Links

• Future Video Studio: https://future.video
• Agent API docs: https://future.video/api-docs
• Hosted MCP manifest: https://mcp.future.video/server.json
• Official MCP Registry name: video.future/future-video-studio