{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_ntspz8brut33","handle":"volcengine-video-mcp","url":"https://wellknown.network/agents/volcengine-video-mcp","links":{"self":"https://wellknown.network/agents/volcengine-video-mcp/record.json","html":"https://wellknown.network/agents/volcengine-video-mcp","markdown":"https://wellknown.network/agents/volcengine-video-mcp/record.md","api":"https://wellknown.network/api/v1/agents/volcengine-video-mcp","status":"https://wellknown.network/api/v1/agents/volcengine-video-mcp/status","claim":"https://wellknown.network/agents/volcengine-video-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/volcengine-video-mcp/claim.json","badge":"https://wellknown.network/agents/volcengine-video-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:volcengine-video-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"volcengine-video-mcp","summary":"MCP server for Volcengine (Doubao) Video Generation API","description":"# Volcengine Video Generation MCP Server\n\nMCP (Model Context Protocol) server for Volcengine (Doubao/豆包) Video Generation API - Seedance models.\n\n## Features\n\n- ✅ **Text-to-Video Generation** - Generate videos from text prompts\n- ✅ **Image-to-Video Generation** - Animate images with multiple modes:\n  - First frame mode\n  - First & last frame mode\n  - Reference images mode (1-4 images)\n- ✅ **Task Management** - Query, list, and cancel video generation tasks\n- ✅ **Comprehensive Parameters** - Full control over resolution, ratio, duration, FPS, etc.\n- ✅ **MCP Resources** - Server status, models list, and API documentation\n\n## Installation\n\n### Prerequisites\n\n- Python 3.11+\n- [uv](https://github.com/astral-sh/uv) (recommended) or pip\n\n### Setup\n\n1. Clone the repository:\n```bash\ngit clone <repository-url>\ncd volcengine-video-mcp\n```\n\n2. Install dependencies:\n```bash\n# Using uv (recommended)\nuv sync\n\n# Or using pip\npip install -e .\n```\n\n3. Configure environment variables:\n```bash\ncp .env.example .env\n# Edit .env and add your Volcengine API key\n```\n\nRequired environment variables:\n- `ARK_API_KEY`: Your Volcengine API key ([Get one here](https://console.volcengine.com/ark))\n- `ARK_BASE_URL`: (Optional) API base URL, defaults to `https://ark.cn-beijing.volces.com`\n\n## Usage\n\n### Running the Server\n\n```bash\n# Using uv\nuv run python app/main.py\n\n# Or if installed with pip\npython app/main.py\n```\n\n### Using with Claude Desktop\n\nAdd to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"volcengine-video\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"--directory\",\n        \"/path/to/volcengine-video-mcp\",\n        \"run\",\n        \"python\",\n        \"app/main.py\"\n      ],\n      \"env\": {\n        \"ARK_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Tools\n\n### create_video_task\n\nCreate a video generation task.\n\n**Example - Text-to-Video:**\n```python\ncreate_video_task(\n    model=\"doubao-s…","publisher":null,"homepage":null,"repository":null,"version":"0.1.1","license":"MIT","protocols":["mcp"],"tags":["ai","doubao","fastmcp","mcp","video-generation","volcengine"],"pricing":null,"endpoints":[{"url":"pypi:volcengine-video-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"media.video-generation","name":"Video Generation","confidence":1,"provenance":"declared"},{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"ai.prompting","name":"Prompt Management","confidence":0.791,"provenance":"derived"}],"categories":["ai","dev","media"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"volcengine-video-mcp","registry":"pypi","observedAt":"2026-09-10T15:25:17.305Z","publishedAt":"2025-11-06T05:12:46.018443Z","latestVersion":"0.1.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"volcengine-video-mcp","url":"https://pypi.org/project/volcengine-video-mcp/","firstSeenAt":"2026-09-10T15:23:53.807Z","fetchedAt":"2026-09-10T15:23:53.807Z","normalizedAt":"2026-09-10T15:23:53.807Z"}]},"firstSeenAt":"2026-09-10T15:23:53.807Z","updatedAt":"2026-09-10T15:25:17.305Z"}