Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

CraftStory

von itseez3dVersion 0.8.0i★ 0iComputer oder CloudOffizielle Website ↗
Name in der Registryio.github.itseez3d/craftstory-mcp

So installierst du es

What it does

Talking-avatar videos from a photo, short clips with sound, images and music.

  • Connects Computer oder Cloud
  • Account or key Cloud: Sign in to the service when you connect (OAuth) · Local: Needs CRAFTSTORY_API_KEY
  • Category Design, Bilder & Audio

Zusammen nutzen mit

Skills, die der KI diese Art Arbeit beibringen; sie funktionieren zusammen mit diesem

impeccable

The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop before it ships.

von pbakaus★ 112.5441 Skills

Skill · Anleitung

diagram-design

Editorial diagram design for Claude Code, Codex, GitHub Copilot, Cursor, Factory Droid, Qoder, and Pi. 45 diagram types. Self-contained HTML + SVG. No shadows. No Mermaid slop.

von cathrynlavery★ 68.0691 Skills

Skill · Anleitung

frontend-slides

Create beautiful slides on the web using a coding agent's frontend skills

von zarazhangrui★ 32.5141 Skills

Skill · Anleitung

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit0/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch8/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert20/100

Qualität: 5/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte CraftStory. Folge https://mcp.popnx.com/i/itseez3d-craftstory-mcp.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

5/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (mcp.craftstory.com) · ✓ Befehle geprüft am 13. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 2 Min.

Kein Schlüssel, nichts zu installieren · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameCraftStory
    Remote MCP server URL · Adressehttps://mcp.craftstory.com/mcp

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  3. Im Chat einschalten

    +ConnectorsCraftStory

  4. Ausprobieren

    Nutze CraftStory und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es CraftStory nutzt, oder ein Werkzeug von CraftStory in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit ChatGPT je nach Tarif

Volles MCP: ChatGPT Business, Enterprise oder Edu im Web · Pro: verbindet mit Lese-/Abrufrechten, Werkzeuge, die Daten ändern, gehen evtl. nicht · Plus: in der Doku nicht bestätigt; siehst du auf der Plugins-Seite eine Option für eigene MCP-Server, kannst du es versuchen · nur Web

  1. In ChatGPT im Web die Seite zum Hinzufügen von MCP öffnen

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Name und Adresse eintragen

    Namen eingeben, Adresse unter Connection einfügen, Risikohinweis abhaken und Create as a plugin klicken

    Name · NameCraftStory
    Connection · Adressehttps://mcp.craftstory.com/mcp
  3. CraftStory im Chat auswählen

    Neuen Chat öffnen und vor dem Tippen CraftStory aus deinen Plugins wählen

  4. Ausprobieren

    Nutze CraftStory und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn ChatGPT sagt, dass es CraftStory nutzt, oder ein Werkzeug von CraftStory in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von OpenAI abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Claude Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  2. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http --scope user craftstory https://mcp.craftstory.com/mcp
  3. /mcp in Claude Code eingeben

    CraftStory sollte in der Liste als verbunden erscheinen

  4. Ausprobieren

    Nutze CraftStory und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es CraftStory nutzt, oder ein Werkzeug von CraftStory in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in Cursor im Agent-Modus öffnen

  3. Ausprobieren

    Nutze CraftStory und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es CraftStory nutzt, oder ein Werkzeug von CraftStory in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in VS Code im Agent-Modus öffnen

  3. Ausprobieren

    Nutze CraftStory und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es CraftStory nutzt, oder ein Werkzeug von CraftStory in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://mcp.craftstory.com/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die CraftStory nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user craftstory https://mcp.craftstory.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "craftstory": {
      "url": "https://mcp.craftstory.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "craftstory": {
      "type": "http",
      "url": "https://mcp.craftstory.com/mcp"
    }
  }
}

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user craftstory --env CRAFTSTORY_API_KEY=your-value -- npx -y @craftstory/mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "craftstory": {
      "command": "npx",
      "args": [
        "-y",
        "@craftstory/mcp"
      ],
      "env": {
        "CRAFTSTORY_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "craftstory": {
      "command": "npx",
      "args": [
        "-y",
        "@craftstory/mcp"
      ],
      "env": {
        "CRAFTSTORY_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "craftstory": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@craftstory/mcp"
      ],
      "env": {
        "CRAFTSTORY_API_KEY": "your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

  • CRAFTSTORY_API_KEY geheim erforderlich env
    CraftStory API key (sk-cs-...), created in the app under Account -> API Access; requires a plan with API access

Die Beschreibungen sind noch im englischen Original.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
95/Wo.
Verbindung
Computer oder Cloud
Transport
stdio, streamable-http
Neueste Versioni
0.8.0
In der Registry veröffentlichti
26. Okt. 2026
Code zuletzt geänderti
26. Okt. 2026
Zuletzt geprüft
17. Nov. 2026
Entwickler
itseez3d
Pakete
npm: @craftstory/mcp
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Der Server verlangt eine Anmeldung, bevor er seine Tools auflistet.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto itseez3d bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 24 Tagen

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 231 ms (HTTP 401)

  • ✓ Bestanden

    Anmeldung mit OAuth

    Gibt OAuth-Anmeldung an, damit deine KI-App dich zum Einloggen weiterleiten kann

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Noch nicht geprüft; wir lesen die Tool-Liste, wenn wir den Endpunkt prüfen

Veröffentlichte Schwachstellen (OSV.dev)

Keine Einträge auf OSV.dev für @craftstory/mcp@0.8.0

Prüft nur diese Paketversion, nicht alle Abhängigkeiten · geprüft 15. Nov. 2026

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/itseez3d-craftstory-mcp.svg)](https://mcp.popnx.com/en/servers/itseez3d-craftstory-mcp)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Design, Bilder & Audioi

  • Mehr Sterne als 0 % der anderen 3275 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 57 % der anderen 3275 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 3275 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist CraftStory sicher?

Er hat 5 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: CRAFTSTORY_API_KEY

Läuft er auf meinem Computer oder in der Cloud?

Beides geht: Installiere ihn auf deinem Computer oder verbinde dich mit der Cloud-Version.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 24 Tagen geändert, und die neueste Version (0.8.0) kam vor 24 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: HyperFrames by HeyGen, Pascal 3D Editor, draw.io, Figma MCP Server, Remocn: Remotion MCP server

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

HyperFrames by HeyGen

Official HyperFrames by HeyGen: the best AI video editor in chat. Captions, motion graphics, MP4.

von heygen-comWeit verbreitet★ 86.388 Sterne des ganzen ReposAktualisiert gestern

Läuft in der Cloud✓ heygen.com

Pascal 3D Editor

Create, inspect, validate, and save editable 3D building scenes with Pascal's MCP server.

von pascalorgWeit verbreitet↓ 1037/Wo.★ 25.603 Sterne des ganzen ReposAktualisiert gestern

Computer oder Cloud✓ vom Dienst · pascal.app

draw.io

Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.

von jgraphWeit verbreitet★ 5848Aktualisiert vorgestern

Läuft in der Cloud✓ vom Dienst · draw.ioVom PopNx-Team ausprobiert

Figma MCP Server

The Figma MCP server brings Figma design context directly into your AI workflow.

von figmaWeit verbreitet★ 2207Aktualisiert vor 13 Monaten

Läuft in der Cloud✓ vom Dienst · mcp.figma.com

Remocn: Remotion MCP server

Hosted MCP for Remotion videos: search Remocn components, read docs, plan a video, preview it.

von RemocnWachsend★ 1796Aktualisiert vor 9 Tagen

Läuft in der Cloud✓ vom Dienst · remocn.dev
Im Vergleich mit ähnlichen
Dieser
CraftStory
HyperFrames by HeyGenPascal 3D Editordraw.ioFigma MCP ServerRemocn: Remotion MCP server
Läuft woIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselJaNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinJaNeinNeinJaNein
Basisprüfungen5/54/45/54/44/44/4
LizenzMITApache-2.0MITApache-2.0–MIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

CraftStory MCP server

Generate talking-avatar videos from Claude, Cursor, Claude Code or any other MCP client, using the CraftStory API:

  • CraftStory 2.0 - a talking video of any length from one photo plus an audio clip (script + voice, your own recording, or a custom avatar). 8-15 minutes per video.
  • MiniMax H3 - a clip of up to 15 s from one photo: description-driven with generated sound, audio-driven with lip-sync, or the reference model without audio (the lines written in the description are voiced; extra photos keep a second person or a product consistent). 1-3 minutes.

You need Node.js 20 or newer, a CraftStory account on a plan with API access, and an API key (app: Account -> API Access, keys look like sk-cs-...). Generations are billed in credits exactly like in the app; failed jobs are refunded.

Config

Standard MCP configuration, identical for every client (Claude Desktop, Cursor, Windsurf, VS Code, Zed...):

{

"mcpServers": { "craftstory": { "command": "npx", "args": ["-y", "@craftstory/mcp"], "env": { "CRAFTSTORY_API_KEY": "sk-cs-..." } } } }

Install

claude.ai, Claude Desktop and mobile: hosted connector

No key and nothing to install; connectors belong to your Claude account, so one setup covers web, desktop and mobile. In claude.ai open Settings → Connectors → Add custom connector, paste https://mcp.craftstory.com/mcp, open the advanced settings and set OAuth Client ID to hAlwpyaDeO0CmuEKMibZxiXxtTT09NXL (public, no secret), then sign in with your CraftStory account. The account needs a plan with API access (Producer). The hosted server speaks Streamable HTTP with OAuth 2.1 (Auth0) and runs the same tools as the package below; local file paths and chat attachments are not available there: pass a public URL, or let Claude call request_file_upload and drop the photo on the one-time upload page it returns.

Claude Code
claude mcp add --scope user craftstory -e CRAFTSTORY_API_KEY=sk-cs-... -- npx -y @craftstory/mcp

(--scope user makes it available in every project; drop it to install for the current project only.)

Claude Desktop

Add to claude_desktop_config.json (Settings -> Developer -> Edit Config), then restart Claude Desktop; the server shows up under the tools icon:

{

"mcpServers": { "craftstory": { "command": "npx", "args": ["-y", "@craftstory/mcp"], "env": { "CRAFTSTORY_API_KEY": "sk-cs-..." } } } }

Cursor / other clients

Same shape in ~/.cursor/mcp.json (user-level, so the key never lands in a repository): command npx, args ["-y", "@craftstory/mcp"], env CRAFTSTORY_API_KEY. In a project-level .cursor/mcp.json prefer "CRAFTSTORY_API_KEY": "${env:CRAFTSTORY_API_KEY}" and keep the real key in your shell environment.

Environment variables: CRAFTSTORY_API_KEY (required), CRAFTSTORY_API_BASE (optional, default https://api.craftstory.com/api/v1; must be https unless CRAFTSTORY_ALLOW_HTTP=1).

Tools

Upload links (hosted mode and local alike): request_file_upload(kind=image|audio|video) → one-time page for the user → wait_for_upload / get_upload. Images: file_url goes into image_url, or the upload_id into create_image(image_upload_ids). Audio: upload_id goes into create_audio_clip(audio_upload_id). Audio/video: upload_id goes into reference_upload_ids of the MiniMax H3 tools. Limits: 20 MB for photos, 100 MB for audio and video.

  • list_models: Models, status (a paused model answers 503), limits and prices
  • list_voices: Library voices; include_cloned adds your cloned voices
  • list_avatars: Your custom avatars, or the scenes of one avatar
  • create_audio_clip: Speech from text + voice, or upload a local recording
  • preview_cost: Credit estimate for a CraftStory 2.0 video
  • create_craftstory2_video: Start a CraftStory 2.0 job (photo or avatar scene + audio clips)
  • create_minimax_h3_video, create_minimax_h3_avatar_video: Start a MiniMax H3 job (basic, or reference mode with or without audio)
  • create_cloud_video, preview_cloud_video_cost: A clip from a photo as the first frame with one of the cloud models: seedance-2.5 (4-30 s), flux-3-video / flux-3-max (5-20 s, 720p/1080p), minimax-h3-max and heygen-video (5-15 s, 480p/768p/1080p), gemini-omni-flash (3-10 s, 720p); the model writes and speaks its own soundtrack
  • get_job_status: Status, percentage, failure reason, refund flag
  • get_job_result: Full record with the signed video URL (valid 7 days)
  • wait_for_job: Bounded polling (default 45 s, max 55 s); call again while state is running
  • upscale_video: New job with the upscaled result (CraftStory 2.0 720p -> 1080p, H3 and the cloud models 2x)
  • create_image: an image from a prompt, optionally from up to 8 of your pictures; model nano-banana (10 credits, default), nano-banana-pro (39), seedream-5-pro (13) or flux-3 (14); aspect_ratio 9:16, 16:9, 4:5, 1:1, 3:4, 4:3. The result's image_url goes straight into the video tools
  • create_music: Music track of 5-180 s from a description, instrumental by default (1 credit per second); a declined prompt comes back with prompt_suggestion
  • create_sound_effect: Sound effect or ambience of 0.5-30 s (or auto length), optional seamless loop (1 credit per started 5 s, 2 minimum)

Plus the prompt talking_video_from_photo (script + photo) that walks the model through the whole flow.

Example

Make a portrait video of the person in /Users/me/photos/portrait.jpg saying "Welcome to our spring collection", calm gestures.

The assistant will: list_voices -> create_audio_clip -> wait_for_job(audio-clip) -> preview_cost -> create_craftstory2_video (resolution 720_1280, or 768_960 for 4:5, gestures calm) -> wait_for_job(craftstory-2) a few times -> get_job_result -> the video URL.

Long jobs: wait_for_job returns within timeout_s (default 45 s, max 55 s) plus a few seconds for the final result fetch; every request inside it is capped by the time left, so it stays under the 60 s tool-call limit of most clients. A CraftStory 2.0 video needs several calls; that is by design so agent runtimes do not time out. A CraftStory 2.0 video needs several calls; that is by design so agent runtimes do not time out.

Local files vs URLs

Photos accept image_url (JPG/PNG) or image_path (absolute path or ~/...; JPG/PNG/HEIC, up to 20 MB, uploaded as multipart). Recordings and extra references are local paths too. Anything you pass as a path is uploaded to the CraftStory API, so keep your client's tool-approval prompts on (see SECURITY.md).

Hosted server (operators)

craftstory-mcp-http serves the same tools over Streamable HTTP behind OAuth. Required env: MCP_PUBLIC_URL, AUTH0_DOMAIN; optional MCP_AUDIENCE (defaults to /mcp), CRAFTSTORY_API_BASE, PORT (8788), MCP_ALLOWED_ORIGINS, MCP_TRUST_PROXY=1 behind a load balancer. Protected-resource metadata is at /.well-known/oauth-protected-resource/mcp; access tokens are verified against the tenant's JWKS and forwarded to the CraftStory API, nothing is stored. Dockerfile builds the production image.

Development

npm install

npm run build CRAFTSTORY_API_KEY=sk-cs-... npm run smoke # live check over stdio: lists tools, makes an audio clip, previews cost

add "-- --h3" and SMOKE_IMAGE=/path/to/photo.jpg to also render a 5 s MiniMax H3 clip (costs 17 credits)

npm test

Full API reference: https://api.craftstory.com/api/v1/docs/public/ and the curl walkthrough at https://api.craftstory.com/api/v1/docs/samples/curl/.

Privacy Policy

This server runs on your machine and keeps no data of its own. It sends your API key and the inputs you pass to tools (text, photos, audio, reference files) only to the CraftStory API at CRAFTSTORY_API_BASE (default https://api.craftstory.com), where they are processed under the CraftStory privacy policy: https://craftstory.com/privacy/. Generated videos and uploaded files are stored in your CraftStory account and can be deleted there or via the API; nothing is retained locally by the server. No analytics or third-party services are called by the server itself. Questions: support via https://craftstory.com/contacts/.

License

MIT