Video and Image Spoofer for Claude: Spoofzy MCP server and skill

Spoof images and videos with Spoofzy from Claude Code, Claude Desktop or any other Model Context Protocol client. Ask Claude for unique versions of your photos and clips, strip hidden metadata, or run your saved Spoofzy Cloud workflows. Results land next to your originals.

You:     Make 5 unique versions of every video in ~/Reels/drop-12, keep the captions readable.
Claude:  That's 4 videos × 5 versions with the minimal look, included in your plan. Results go to
         ~/Reels/drop-12/spoofzy-output. Go ahead?
You:     yes
Claude:  Done: 20 files saved in ~/Reels/drop-12/spoofzy-output (beach-spoofzy-01.mp4 … sunset-spoofzy-05.mp4).

• Spoof: make 1, 5, 10, 20, 30, 40 or 50 unique versions per file with the classic, subtle, stronger or minimal (text- and layout-preserving) look, plus optional mirror, 1080p/4K export, watermark and border.
• Clean metadata: remove GPS location, device details and capture dates from photos and videos.
• Workflows: run saved Spoofzy Cloud workflows (for example Caption → Spoof ×5) on local files or saved originals.
• One file, no dependencies: spoofzy_mcp.py needs only Python 3.9 or later.

1. Get a Spoofzy API key

Use either key, or both:

Key	Where	Best for
Spoofzy Cloud API key (spc_…)	Spoofzy Cloud → Developers → Create API key	Everything: spoofing on your plan, Studio looks, Metadata Cleaner, workflows
Prepaid Spoofer API key (spz_…)	/api in the Spoofzy Telegram bot	Prepaid spoofing units for automations

For a Cloud key, tick Read jobs and results and Upload and run processing. Add Read workflows and history and Run saved workflows to use workflows, and Read saved originals and voices to list your library.

Keep keys out of chats, prompts and repositories. The steps below store them outside the conversation.

2. Install

Claude Code (plugin: MCP server + skill)

In Claude Code:

/plugin marketplace add spoofzy/video-image-spoofer-mcp
/plugin install spoofzy@spoofzy

Or from a terminal:

claude plugin marketplace add spoofzy/video-image-spoofer-mcp

claude plugin install spoofzy@spoofzy

Then save your key (step 3) and restart Claude Code. The skill is available as /spoofzy:spoof, and Claude also uses it automatically when you ask to spoof media.

Claude Code (MCP server only)

curl -fsSLo ~/spoofzy_mcp.py https://raw.githubusercontent.com/spoofzy/video-image-spoofer-mcp/main/spoofzy_mcp.py

claude mcp add spoofzy --scope user --env SPOOFZY_WAIT_SECONDS=600 -- python3 ~/spoofzy_mcp.py

Claude Desktop

Download spoofzy-<version>.mcpb from Releases and open it. Claude Desktop asks for your key and stores it in the system keychain. Python 3.9+ must be installed. macOS includes it with the Xcode Command Line Tools.

Or add it by hand to claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "spoofzy": {
      "command": "python3",
      "args": ["/absolute/path/to/spoofzy_mcp.py"]
    }
  }
}

Other MCP clients (Cursor, VS Code, Codex, Windsurf, …)

Any client that runs stdio servers works. With uv installed, no download is needed:

{
  "mcpServers": {
    "spoofzy": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/spoofzy/video-image-spoofer-mcp", "spoofzy-mcp"]
    }
  }
}

Without uv, use "command": "python3" and the path to spoofzy_mcp.py, as in the Claude Desktop example.

3. Save your key

Run setup once in a terminal. It asks for your key(s) without echoing them and saves them to ~/.config/spoofzy/credentials.json (%APPDATA%\spoofzy on Windows), readable only by you. Every install on the machine uses that file.

python3 ~/spoofzy_mcp.py setup

Plugin users can run setup from any copy of the script (the curl command above downloads one) or with uvx --from git+https://github.com/spoofzy/video-image-spoofer-mcp spoofzy-mcp setup. You can also set environment variables instead: SPOOFZY_CLOUD_API_KEY and/or SPOOFZY_API_KEY. Check everything with:

python3 ~/spoofzy_mcp.py doctor

Using it

Just ask:

• "Spoof ~/Desktop/post.jpg"
• "Make 10 versions of ~/Videos/clip.mov, mirrored, exported at 1080p"
• "Make 5 versions of everything in ~/Reels/new with the minimal look"
• "Remove the location and camera info from ~/Pictures/IMG_2041.HEIC"
• "Run my 'Caption + Spoof' workflow on ~/Videos/hook.mp4"
• "Is my Spoofzy run done yet?"

Claude checks your plan with spoofzy_account, confirms what will run and what it costs, then saves the results as <name>-spoofzy-01.<ext>, -02, … in a spoofzy-output folder next to each file. Existing files are never overwritten. Long videos keep processing after Claude's call returns and are saved automatically when ready, or on request with spoofzy_get_run.

Tools

Tool	What it does
spoofzy_account	Connection, plan, available tools, costs, limits and prepaid units
spoofzy_spoof	Make unique versions of local images/videos (files or folders, up to 20 per call)
spoofzy_clean_metadata	Strip GPS, device and date metadata (Cloud)
spoofzy_get_run	Check a run, optionally waiting for it
spoofzy_download	Save the results of any finished run
spoofzy_list_runs	Recent runs from this session and Spoofzy Cloud
spoofzy_list_workflows	Saved Spoofzy Cloud workflows
spoofzy_run_workflow	Run a saved workflow on local files, a saved original or a script
spoofzy_list_saved_originals	Originals saved in your Spoofzy library

This is the beginning of the README. Read the rest at the original. Read the full README ↗