Metadata-Version: 2.5
Name: visionstory-mcp
Version: 0.0.1
Summary: MCP server for the VisionStory API - task-oriented tools for AI talking-avatar video generation.
Project-URL: Homepage, https://openapi.visionstory.ai/docs
Project-URL: Documentation, https://openapi.visionstory.ai/docs
Author-email: VisionStory <register@visionstory.ai>
License-Expression: MIT
License-File: LICENSE
Keywords: agent,ai,avatar,mcp,model-context-protocol,talking-avatar,video-generation,visionstory
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
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.10
Requires-Dist: mcp<2,>=1.2.0
Requires-Dist: visionstory>=0.0.1
Description-Content-Type: text/markdown

# visionstory-mcp

MCP server for the [VisionStory API](https://openapi.visionstory.ai/docs) — task-oriented tools that let AI agents (Claude Desktop, Cursor, and any Model Context Protocol client) generate AI talking-avatar videos without writing code.

It exposes nine tools — `generate_video`, `get_video`, `create_avatar`, `list_avatars`, `clone_voice`, `list_voices`, `list_models`, `get_credits`, `upload_asset` — each a thin wrapper over the VisionStory REST API via the [`visionstory`](https://pypi.org/project/visionstory/) SDK.

## Install & run

Requires an API key — create one at [visionstory.ai/openapi](https://www.visionstory.ai/openapi) (Pro plan and up) and set it as `VISIONSTORY_API_KEY`.

Add it to Claude Desktop (or any MCP client):

```json
{
  "mcpServers": {
    "visionstory": {
      "command": "uvx",
      "args": ["visionstory-mcp"],
      "env": { "VISIONSTORY_API_KEY": "sk-vs-xxxxxxxxxxxxxxxxxxx" }
    }
  }
}
```

`generate_video` submits and polls to completion, returning the final video URL — one call in, one result out.

## Run standalone

```bash
export VISIONSTORY_API_KEY="sk-vs-xxxxxxxxxxxxxxxxxxx"
uvx visionstory-mcp          # or: python -m visionstory_mcp
```

## License

MIT
