Axiom Lab MCP Server, CLI & SDKs (azimo)

Official Model Context Protocol (MCP) server, azimo command-line client, Python SDK, and TypeScript SDK for Axiom Lab — turn PDF pitch decks, PPTX slides, UI screenshots, product photos, and written briefs into QA-checked commercial videos.

• Website: https://axiomlab.online

• Official MCP Registry: io.github.Axiom-lab-tech/axiomlab-mcp

• MCP & Agent Guide: English · 中文文档

• REST API Reference: https://axiomlab.online/developers/api

• Claude Skill (SKILL.md): skills/azimo/SKILL.md · Online Guide

• Full Playable Examples: https://axiomlab.online/examples

• Free Pitch & Startup Calculators: https://axiomlab.online/tools

Two Ways to Connect via MCP

Option 1: Remote Streamable HTTP MCP (Zero Local Install)

Point Claude Code, Cursor, or any Streamable HTTP MCP client directly at https://axiomlab.online/mcp using an API key from https://axiomlab.online/dev:

claude mcp add --transport http azimo https://axiomlab.online/mcp \
  --header "Authorization: Bearer $AZIMO_API_KEY"

Or in ~/.cursor/mcp.json / claude_desktop_config.json:

{
  "mcpServers": {
    "azimo": {
      "url": "https://axiomlab.online/mcp",
      "headers": {
        "Authorization": "Bearer ${env:AZIMO_API_KEY}"
      }
    }
  }
}

Option 2: Local stdio MCP Server (azimo mcp)

Run the local stdio MCP server directly on macOS, Linux, or Windows (enables direct local file path uploads up to 60 MB per file without base64 inline limits):

pip install "git+https://github.com/Axiom-lab-tech/axiomlab-mcp.git"

Configure in claude_desktop_config.json or ~/.cursor/mcp.json:

{
  "mcpServers": {
    "azimo": {
      "command": "azimo",
      "args": ["mcp"],
      "env": {
        "AZIMO_API_KEY": "vg_..."
      }
    }
  }
}

Or launch ephemeral via uvx:

uvx --from "git+https://github.com/Axiom-lab-tech/axiomlab-mcp.git" azimo mcp

Related MCP server: Motion MCP

Available MCP Tools (14 Tools, 4 Prompts, 2 Resources)

• MCP Prompts (4): create_product_video, create_company_intro, create_project_intro, create_person_card

• MCP Resources (2): azimo://workflows, azimo://video-types

Safety by design: Plans are always free. Production and billing only start after explicit confirmation, and viewer-role API keys can inspect plans and progress without permission to spend balance.

Python SDK

import os
from vidgen_sdk import Vidgen

with Vidgen("https://axiomlab.online", os.environ["AZIMO_API_KEY"]) as api:
    asset = api.upload_asset("deck.pdf")
    plan = api.create_plan(
        {
            "prompt": "Explain in 60 seconds how our inventory platform cuts warehouse stockouts",
            "assets": [asset["id"]],
            "options": {"workflow": "auto", "duration_max": 60},
        },
        idempotency_key="launch-plan-001",
    )
    if plan["data"]["status"] == "ready":
        job = api.create_video(plan_id=plan["id"], idempotency_key="launch-video-001")
        final = api.wait(job["id"])
        stop = (final.get("result") or {}).get("input_required") or {}
        if stop.get("code") == "confirm_duration":
            api.confirm_duration(job["id"], stop["suggested_duration_sec"], idempotency_key="launch-length-001")
            final = api.wait(job["id"])

TypeScript SDK (typescript/)

See typescript/README.md for the zero-dependency Node.js 22+ / Web Crypto TypeScript client (@vidgen/sdk).

License

MIT © Axiom Lab