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
Chalk Labs
Need help deploying Puppetry?
Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.
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
Reviews
Write a reviewNo 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_statuslist_voicespuppetry_get_job_statuspuppetry_get_quotapuppetry_list_voices
Write 4 · Create, change, send or run things.
create_puppetpuppetry_create_audio_upload_urlpuppetry_create_video_from_audiopuppetry_create_video_from_text
Not yet classified 2 · We could not tell from the name and description.
animate_audiopuppetry_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_audioAnimate 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_puppetTurn 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_statusCheck the status of a Puppetry video generation job. Returns status (queued/processing/completed/failed), progress percentage, and the download URL when complete.
list_voicesList 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_urlReserve 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_audioCreate a talking-head video from a portrait image and an existing audio URL.
puppetry_create_video_from_textCreate a talking-head video from a portrait image and text. Returns a job ID for polling.
puppetry_get_job_statusFetch a generated video job by ID.
puppetry_get_quotaCheck the current Puppetry API key video credit balance and monthly usage.
puppetry_lipsyncLip-sync a portrait or puppet with an existing audio URL. Alias of puppetry_create_video_from_audio.
puppetry_list_voicesList 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
Done for you
Rather not set it up yourself?
Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.
See how we build AI agents →Read the case studies
Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.
- launches shipped
- 50+
- launches shipped
- media placements
- 500+
- media placements
- founders on every account
- 2
- founders on every account
Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block
Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.
Get Puppetry running in your business
Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.
Cite this page
Puppetry MCP server. Agent Mart. https://agentmart.dev/connectors/puppetry-com-mcp-server (last updated 2026-10-24)