Puppetry

Turn a portrait photo and a script into a talking-head AI video via the Puppetry API.

Connector by puppetry.comOfficial · Domain verified by the MCP Registry

IndexedLicense unknownLocal (stdio)

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/puppetry-com-mcp-server

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

Turn a portrait photo and a script into a talking-head AI video via the Puppetry API.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools: 5 read · 4 write · 0 delete · 2 not yet classified
Secrets: 1 (API keys, tokens or passwords)
Install scripts: None found
Runs as: Node.js package

Tools by what they do 11

Read from the source code; the running server may list different tools.

Read 5 · Look things up without changing anything.

get_video_status
list_voices
puppetry_get_job_status
puppetry_get_quota
puppetry_list_voices

Write 4 · Create, change, send or run things.

create_puppet
puppetry_create_audio_upload_url
puppetry_create_video_from_audio
puppetry_create_video_from_text

Not yet classified 2 · We could not tell from the name and description.

animate_audio
puppetry_lipsync

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

PUPPETRY_API_KEY

Tools (11)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

animate_audio
Animate a portrait photo with your own audio file. The puppet will lip-sync to the provided audio. Returns a task_id — use get_video_status to check when the video is ready.
create_puppet
Turn a portrait photo into a realistic talking-head video. Provide an image URL, a text script, and a voice ID. The puppet will speak the script with lip-synced animation. Returns a task_id — use get_video_status to check when the video is ready.
get_video_status
Check the status of a Puppetry video generation job. Returns status (queued/processing/completed/failed), progress percentage, and the download URL when complete.
list_voices
List available AI voices for Puppetry. Returns voice ID, name, language, gender, and preview URL. Over 500 voices across 29 languages. Filter by language or gender.
puppetry_create_audio_upload_url
Reserve a signed Puppetry-hosted audio upload URL. PUT the audio bytes to uploadUrl, then pass readUrl to puppetry_create_video_from_audio.
puppetry_create_video_from_audio
Create a talking-head video from a portrait image and an existing audio URL.
puppetry_create_video_from_text
Create a talking-head video from a portrait image and text. Returns a job ID for polling.
puppetry_get_job_status
Fetch a generated video job by ID.
puppetry_get_quota
Check the current Puppetry API key video credit balance and monthly usage.
puppetry_lipsync
Lip-sync a portrait or puppet with an existing audio URL. Alias of puppetry_create_video_from_audio.
puppetry_list_voices
List Puppetry voices for agent integrations. Supports the same language/gender filters as list_voices.

Signals

Last release: Jul 13, 2026 (3 months ago)

Details

Registry name: com.puppetry/mcp-server
Version: 0.1.1
Auth: API key
Packages: npm @puppetry.com/mcp-server
License: License unknown
Website: www.puppetry.com/developer
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: Official MCP Registry

Cite this page

Puppetry MCP server. Agent Mart. https://agentmart.dev/connectors/puppetry-com-mcp-server (last updated 2026-10-24)