puppetto logo puppetto
The marketing MCP

Onboard your marketing agent with one Puppetto prompt.

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.

Org-scoped tools
Key-gated
Copy-ready handoff

Concept to talking head

One workflow

Source concept

Launch the Puppetto MCP to AI-forward marketers: the marketing MCP that lets your AI assistant run social, campaigns, and merch.

Audience: marketersTone: confidentLength: 20s

The same page copy seeds the generated script.

One-click onboarding

Give your agent the whole Puppetto setup path.

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.
What your agent can do

One token. The full story-to-campaign workflow.

The MCP tool surface now covers onboarding templates, characters, voices, scripts, generated media, async job status, social targets, schedules, and agent email intake.

Onboard

Create a verified signup handoff, poll completion, then pick a creative template and create the first campaign bundle.

  • puppetto_create_verified_onboarding
  • puppetto_get_verified_onboarding_status
  • puppetto_list_onboarding_templates

Cast

Create characters, assign usable organization voices, and attach profile images from completed assets.

  • puppetto_create_starter_character
  • puppetto_list_character_voices
  • puppetto_update_character_profile

Generate

Queue images, speech, video, or other assets, then poll async jobs in bulk before attaching outputs.

  • puppetto_list_asset_generation_integrations
  • puppetto_generate_asset
  • puppetto_list_asset_generation_jobs

Publish

Set social targets, schedule posts, and open an AgentMail inbox for customer story intake.

  • puppetto_set_post_targets
  • puppetto_update_post_schedule
  • puppetto_create_agent_email_inbox
Public asset proof

Every generated asset can come back with URLs an agent can use.

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.

Connect

Use the normal auth path, then hand off.

  1. 1Connect the full Puppetto MCP endpoint at https://mcp.puppetto.com/mcp.
  2. 2Call puppetto_create_verified_onboarding and send the returned signup link to the human.
  3. 3List activation offers and record links/artifacts as the agent creates them.
  4. 4Poll puppetto_get_verified_onboarding_status until it returns the org-scoped MCP config.
  5. 5Reconnect with the returned Streamable HTTP org config and continue the campaign flow.
mcp.json
{
  "mcpServers": {
    "puppetto": {
      "type": "http",
      "url": "https://mcp.puppetto.com/mcp/org/<orgId>/streamable",
      "headers": {
        "x-puppetto-api-v0-key": "${env:PUPPETTO_MCP_API_KEY}"
      }
    }
  }
}
Built for trust

Agents act. You stay in control.

Verified by default

Agents create a signup handoff, but org creation and MCP token release happen only after the human verifies.

Read before write

Tools are designed so agents inspect context first. Stored tokens and secrets are never returned.

Your accounts stay yours

LinkedIn and other connections use attended, user-controlled flows — not background scraping.

Let your agent onboard itself, then ship the campaign.

Copy the prompt, connect your organization, and turn a business problem into character-led content your customers can recognize.