future-video-studio-mcp 0.1.1__tar.gz

future_video_studio_mcp-0.1.1/.github/workflows/publish-pypi.yml

@@ -0,0 +1,26 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+      - name: Install build tools
+        run: python -m pip install --upgrade build
+      - name: Build distributions
+        run: python -m build
+      - name: Publish distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

future_video_studio_mcp-0.1.1/.github/workflows/test.yml

@@ -0,0 +1,23 @@
+name: Tests
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install package
+        run: python -m pip install -e ".[dev]"
+      - name: Run tests
+        run: python -m pytest

future_video_studio_mcp-0.1.1/.gitignore

@@ -0,0 +1,11 @@
+.venv/
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+build/
+dist/
+*.egg-info/
+.env
+.DS_Store

future_video_studio_mcp-0.1.1/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## 0.1.1
+
+- Prepare standalone MCP package repository.
+- Add PyPI package metadata and official MCP Registry package metadata.
+- Document hosted remote MCP and local stdio installation paths.
+
+## 0.1.0
+
+- Initial Future Video Studio MCP server.

future_video_studio_mcp-0.1.1/Dockerfile

@@ -0,0 +1,17 @@
+FROM python:3.12-slim
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    FVS_MCP_TRANSPORT=streamable-http \
+    FVS_AGENT_BASE_URL=https://app.future.video
+
+WORKDIR /app
+
+COPY pyproject.toml README.md ./
+COPY src ./src
+
+RUN python -m pip install --no-cache-dir --upgrade pip \
+    && python -m pip install --no-cache-dir .
+
+CMD ["python", "-m", "fvs_mcp_server"]
+

future_video_studio_mcp-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Future Video Studio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

future_video_studio_mcp-0.1.1/PKG-INFO

@@ -0,0 +1,166 @@
+Metadata-Version: 2.4
+Name: future-video-studio-mcp
+Version: 0.1.1
+Summary: MCP server for creating Future Video Studio renders through the FVS Agent API.
+Project-URL: Homepage, https://future.video
+Project-URL: Documentation, https://future.video/api-docs
+Project-URL: Repository, https://github.com/ariadne-coil/fvs-mcp
+Project-URL: Issues, https://github.com/ariadne-coil/fvs-mcp/issues
+Author: Future Video Studio
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,ai-video,mcp,model-context-protocol,video
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Requires-Dist: mcp>=1.26.0
+Requires-Dist: uvicorn>=0.30.0
+Provides-Extra: dev
+Requires-Dist: build>=1.3.0; extra == 'dev'
+Requires-Dist: pytest>=9.0.0; extra == 'dev'
+Requires-Dist: twine>=6.2.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Future Video Studio MCP
+
+<!-- mcp-name: video.future/future-video-studio -->
+
+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:
+
+```text
+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:
+
+```json
+{
+  "mcpServers": {
+    "future-video-studio": {
+      "url": "https://mcp.future.video/mcp",
+      "headers": {
+        "X-FVS-Agent-Key": "fvs_live_replace_me"
+      }
+    }
+  }
+}
+```
+
+Pay-per-render mode:
+
+```json
+{
+  "mcpServers": {
+    "future-video-studio": {
+      "url": "https://mcp.future.video/mcp"
+    }
+  }
+}
+```
+
+## Local Install
+
+```powershell
+python -m pip install future-video-studio-mcp
+python -m fvs_mcp_server
+```
+
+Example local stdio MCP config:
+
+```json
+{
+  "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
+
+```powershell
+python -m pip install -e ".[dev]"
+python -m pytest
+python -m fvs_mcp_server
+```
+
+Run the HTTP transport locally:
+
+```powershell
+$env:FVS_MCP_TRANSPORT = "streamable-http"
+python -m fvs_mcp_server
+```
+
+## Publishing
+
+Build and check the package:
+
+```powershell
+python -m build
+python -m twine check dist/*
+```
+
+This package is intended to publish to PyPI as:
+
+```text
+future-video-studio-mcp
+```
+
+The MCP Registry package verification marker is the hidden comment near the top
+of this README:
+
+```html
+<!-- 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`

future_video_studio_mcp-0.1.1/README.md

@@ -0,0 +1,136 @@
+# Future Video Studio MCP
+
+<!-- mcp-name: video.future/future-video-studio -->
+
+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:
+
+```text
+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:
+
+```json
+{
+  "mcpServers": {
+    "future-video-studio": {
+      "url": "https://mcp.future.video/mcp",
+      "headers": {
+        "X-FVS-Agent-Key": "fvs_live_replace_me"
+      }
+    }
+  }
+}
+```
+
+Pay-per-render mode:
+
+```json
+{
+  "mcpServers": {
+    "future-video-studio": {
+      "url": "https://mcp.future.video/mcp"
+    }
+  }
+}
+```
+
+## Local Install
+
+```powershell
+python -m pip install future-video-studio-mcp
+python -m fvs_mcp_server
+```
+
+Example local stdio MCP config:
+
+```json
+{
+  "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
+
+```powershell
+python -m pip install -e ".[dev]"
+python -m pytest
+python -m fvs_mcp_server
+```
+
+Run the HTTP transport locally:
+
+```powershell
+$env:FVS_MCP_TRANSPORT = "streamable-http"
+python -m fvs_mcp_server
+```
+
+## Publishing
+
+Build and check the package:
+
+```powershell
+python -m build
+python -m twine check dist/*
+```
+
+This package is intended to publish to PyPI as:
+
+```text
+future-video-studio-mcp
+```
+
+The MCP Registry package verification marker is the hidden comment near the top
+of this README:
+
+```html
+<!-- 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`

future_video_studio_mcp-0.1.1/SECURITY.md

@@ -0,0 +1,10 @@
+# Security
+
+Report security issues privately to support@future.video.
+
+Do not include active FVS Agent API keys, claim tokens, payment URLs, or private
+render assets in public reports.
+
+This MCP can submit wallet-backed renders when configured with an
+`FVS_AGENT_API_KEY`. Agents and clients should request explicit user approval
+before spending account wallet credits.

future_video_studio_mcp-0.1.1/pyproject.toml

@@ -0,0 +1,49 @@
+[project]
+name = "future-video-studio-mcp"
+version = "0.1.1"
+description = "MCP server for creating Future Video Studio renders through the FVS Agent API."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+authors = [
+    { name = "Future Video Studio" }
+]
+keywords = ["mcp", "model-context-protocol", "ai-video", "video", "agents"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Multimedia :: Video",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "mcp>=1.26.0",
+    "uvicorn>=0.30.0",
+]
+
+[project.urls]
+Homepage = "https://future.video"
+Documentation = "https://future.video/api-docs"
+Repository = "https://github.com/ariadne-coil/fvs-mcp"
+Issues = "https://github.com/ariadne-coil/fvs-mcp/issues"
+
+[project.scripts]
+fvs-mcp-server = "fvs_mcp_server.server:main"
+
+[project.optional-dependencies]
+dev = [
+    "build>=1.3.0",
+    "pytest>=9.0.0",
+    "twine>=6.2.0",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/fvs_mcp_server"]

future_video_studio_mcp-0.1.1/server.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "video.future/future-video-studio",
+  "title": "Future Video Studio",
+  "description": "Create and manage cinematic AI video renders through the Future Video Studio Agent API.",
+  "repository": {
+    "url": "https://github.com/ariadne-coil/fvs-mcp",
+    "source": "github",
+    "id": "ariadne-coil/fvs-mcp"
+  },
+  "websiteUrl": "https://future.video",
+  "icons": [
+    {
+      "src": "https://future.video/visuals/FutureVideoIcon.png",
+      "mimeType": "image/png"
+    }
+  ],
+  "version": "0.1.1",
+  "remotes": [
+    {
+      "type": "streamable-http",
+      "url": "https://mcp.future.video/mcp",
+      "headers": [
+        {
+          "name": "X-FVS-Agent-Key",
+          "description": "Optional Future Video Studio Agent API key from Settings > Agent API Access. Omit for Link paid quote mode.",
+          "isRequired": false,
+          "isSecret": true
+        }
+      ]
+    }
+  ],
+  "packages": [
+    {
+      "registryType": "pypi",
+      "identifier": "future-video-studio-mcp",
+      "version": "0.1.1",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}

future_video_studio_mcp-0.1.1/src/fvs_mcp_server/__init__.py

@@ -0,0 +1,5 @@
+"""Future Video Studio MCP server package."""
+
+__all__ = ["__version__"]
+
+__version__ = "0.1.1"

future_video_studio_mcp-0.1.1/src/fvs_mcp_server/__main__.py

@@ -0,0 +1,6 @@
+from .server import main
+
+
+if __name__ == "__main__":
+    main()
+