@mysnapface/mcp

Publishable stdio MCP server for the MySnapFace public API.

Scope

V1 exposes the full MySnapFace public API surface as MCP tools:

• list_characters
• get_character
• generate_character_image
• edit_image
• upscale_image
• generate_video
• clone_video
• generate_voice_note
• add_video_voice_overlay
• generate_image_carousel
• submit_face_swap
• get_face_swap_batch_status
• get_job_status
• get_openapi_spec

All tools call the existing public API under /api/public/v1, so they reuse the same API keys, scopes, entitlements, and rate limits already implemented in the app.

Install

Run directly with npx:

npx -y @mysnapface/mcp

Or install globally:

npm install -g @mysnapface/mcp
mysnapface-mcp

Environment variables

Required:

• MYSNAPFACE_PUBLIC_API_KEY

Optional:

• MYSNAPFACE_PUBLIC_API_BASE_URL

Legacy CYOP_PUBLIC_API_KEY and CYOP_PUBLIC_API_BASE_URL are still accepted for local compatibility.

MYSNAPFACE_PUBLIC_API_BASE_URL should include the public API version path. By default the package uses https://app.mysnapface.com/api/public/v1.

Example:

export MYSNAPFACE_PUBLIC_API_BASE_URL="https://app.mysnapface.com/api/public/v1"
export MYSNAPFACE_PUBLIC_API_KEY="<key_id.secret>"
npx -y @mysnapface/mcp

For local development against a local app server:

export MYSNAPFACE_PUBLIC_API_BASE_URL="http://127.0.0.1:3001/api/public/v1"
export MYSNAPFACE_PUBLIC_API_KEY="<key_id.secret>"
npx -y @mysnapface/mcp

The server exits immediately on startup if MYSNAPFACE_PUBLIC_API_KEY is missing.

Local development

From the repository root:

pnpm run mcp:creators

Or from this package:

pnpm dev

Notes

• Most media submission tools are asynchronous and return a queued job_id or batch_id.
• Use get_job_status to poll image, video, edit, upscale, voice-overlay, and carousel jobs.
• Use get_face_swap_batch_status to poll face swap batches.
• generate_voice_note is synchronous and returns an audio_url.
• For local development, start the creators app first if you point MYSNAPFACE_PUBLIC_API_BASE_URL at http://127.0.0.1:3001/api/public/v1.