Connect Puppetto MCP to Cursor, Claude, Codex, or any agent. Then let it guide setup, create characters, generate assets, schedule campaigns, and open a story-intake inbox.
Concept to talking head
One workflowSource concept
Launch the Puppetto MCP to AI-forward marketers: the marketing MCP that lets your AI assistant run social, campaigns, and merch.
The same page copy seeds the generated script.
The prompt points a fresh agent at the public Puppetto skill, auth guide, campaign guide, and asset guide, then asks it to verify MCP access and complete every core onboarding feature at least once.
Best for Cursor, Claude Desktop, Codex, ChatGPT connectors, and any MCP-aware assistant.
Tokens stay in the client secret store or PUPPETTO_MCP_API_KEY.
Agent handoff
Paste this into any AI agent
You are helping me onboard into Puppetto using Puppetto MCP only.
Use these public setup docs first:
- Skill: https://puppetto.com/skills/puppetto/SKILL.md
- Quickstart: https://puppetto.com/agent-assets/puppetto/mcp-quickstart.md
- Auth guide: https://puppetto.com/agent-assets/puppetto/setup-auth.md
- Campaign guide: https://puppetto.com/agent-assets/puppetto/campaign-onboarding.md
- Asset guide: https://puppetto.com/agent-assets/puppetto/asset-generation.md
- Agent email guide: https://puppetto.com/agent-assets/puppetto/agent-email-onboarding.md
Walk me through the shortest verified path from guest to published campaign:
1. Connect to the full Puppetto MCP endpoint at https://mcp.puppetto.com/mcp using Streamable HTTP.
2. Call puppetto_create_verified_onboarding with my organization name and email if I provide it. Send me the returned signUpUrl. Keep the claimToken private inside your agent session.
3. Call puppetto_list_onboarding_activation_offers and ask whether I want to pursue a credit activation. If I do, call puppetto_accept_onboarding_activation_offer and track proof requirements.
4. Poll puppetto_get_verified_onboarding_status with sessionId and claimToken until the verified signup creates my organization and returns the org-scoped MCP config.
5. Reconnect Puppetto MCP with the returned Streamable HTTP org config:
url: https://mcp.puppetto.com/mcp/org/<orgId>/streamable
header: x-puppetto-api-v0-key
6. Verify access with puppetto_get_authorized_context.
7. Use puppetto_list_onboarding_templates, then prefer puppetto_create_campaign_from_onboarding_template to create a campaign, storyline, starter cast, and draft posts quickly.
8. Set up a character: create/select one, list usable voices with puppetto_list_character_voices, assign voiceId with puppetto_update_character_profile, generate or assign a profile image, then generate speech with puppetto_generate_asset.
9. Generate campaign assets with puppetto_list_asset_generation_integrations, puppetto_estimate_asset_generation, puppetto_generate_asset, and poll with puppetto_list_asset_generation_jobs.
10. For every completed generated asset, call puppetto_get_asset and preserve links.publicUrl, links.displayUrl, links.downloadUrl, plus the snake_case public_url/display_url/download_url aliases if your client prefers them.
11. Connect optional social accounts with puppetto_get_social_connection_links, then use puppetto_set_post_targets, puppetto_add_post_assets, and puppetto_update_post_schedule.
12. Record important created links, object IDs, and public proof URLs with puppetto_record_verified_onboarding_artifact. If an activation is completed, submit proof with puppetto_submit_onboarding_activation_proof.
13. If I want inbound customer story intake, create or bind an AgentMail inbox with puppetto_create_agent_email_inbox and puppetto_update_agent_email_inbox.
14. Finish by calling puppetto_get_verified_onboarding_audit and summarize what was created, what links I should save, and whether any credit activation is pending admin review.The MCP tool surface now covers onboarding templates, characters, voices, scripts, generated media, async job status, social targets, schedules, and agent email intake.
Create a verified signup handoff, poll completion, then pick a creative template and create the first campaign bundle.
Create characters, assign usable organization voices, and attach profile images from completed assets.
Queue images, speech, video, or other assets, then poll async jobs in bulk before attaching outputs.
Set social targets, schedule posts, and open an AgentMail inbox for customer story intake.
Completed assets expose a human review page, a stable download route, and the direct CDN file. Agents should save those links into onboarding audits and campaign handoffs.
{
"mcpServers": {
"puppetto": {
"type": "http",
"url": "https://mcp.puppetto.com/mcp/org/<orgId>/streamable",
"headers": {
"x-puppetto-api-v0-key": "${env:PUPPETTO_MCP_API_KEY}"
}
}
}
}Agents create a signup handoff, but org creation and MCP token release happen only after the human verifies.
Tools are designed so agents inspect context first. Stored tokens and secrets are never returned.
LinkedIn and other connections use attended, user-controlled flows — not background scraping.