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

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 -->

Future Video Studio

Quick Install