Happy Horse MCP Server

Model Context Protocol server for Happy Horse AI video generation and editing through the Ace Data Cloud API.

Capabilities

• Text-to-video generation
• First-frame image-to-video animation
• Reference-to-video generation with 1-9 subject or style images
• Video editing with up to 5 reference images
• 720P and 1080P output
• Single and batch task polling
• Local stdio and hosted Streamable HTTP/SSE transports
• Direct Bearer token and AceDataCloud OAuth authentication

Install

pip install mcp-happyhorse
export ACEDATACLOUD_API_TOKEN="your-token"
mcp-happyhorse

Get a token from platform.acedata.cloud.

Configure

Claude Desktop

{
  "mcpServers": {
    "happyhorse": {
      "command": "uvx",
      "args": ["mcp-happyhorse"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your-token"
      }
    }
  }
}

Hosted MCP

{
  "mcpServers": {
    "happyhorse": {
      "url": "https://happyhorse.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer your-token"
      }
    }
  }
}

The hosted endpoint also supports OAuth-capable MCP clients.

Tools

Generation tools submit asynchronously when no callback_url is supplied. Keep the returned task_id, wait about 15 seconds, then call happyhorse_get_task until the response contains a final video_url or terminal error.

Models

Generation duration is 3-15 seconds. Supported resolutions are 720P and 1080P. Text and reference generation support 16:9, 9:16, 1:1, 4:3, and 3:4. Image-to-video follows the input image ratio. Video-edit duration follows the source video.

Example Requests

Ask your MCP client:

Generate a 720P, 9:16 video of a white horse crossing a snowy ridge at sunrise.

Animate https://example.com/horse.jpg with a slow camera push and wind moving the mane.

Edit https://example.com/source.mp4 to preserve the camera motion but apply the costume style from https://example.com/reference.jpg. Keep the original audio.

Environment

Development

pip install -e ".[all]"
pytest --cov=core --cov=tools
ruff check .
mypy core tools main.py

License

MIT