Quickstart

Modelfy creates product photos: a product worn or held by a model in a real place, or the product alone on a studio background. This MCP server lets any AI agent do it for a person, with their Modelfy account and their credits.

https://mcp.modelfy.ai/mcp

Streamable HTTP. Sign-in with OAuth 2.1 (chat assistants) or a Bearer API key (bots and code).

1. Connect

In Claude Code:

claude mcp add --transport http --scope user modelfy https://mcp.modelfy.ai/mcp

Then run /mcp, pick modelfy and sign in with your Modelfy account. Other clients (claude.ai, ChatGPT, Cursor, VS Code, Codex, Antigravity, Zed, Cline, your own agent) are in Connect your agent.

No account yet? Get a free sandbox key and use it as a Bearer token. Nothing is spent and the photos are samples:

curl -X POST https://mcp.modelfy.ai/sandbox/keys

2. Ask for photos

Make 4 photos of this dress, vertical, on a model in a café: https://shop.example.com/dress.jpg

The agent adds the product photos, picks a model and a place, and plans the session.

3. Say yes to the price

The agent shows the exact price in credits before anything is spent. After your yes it launches the session, waits, and shows the photos when they are ready. See Credits and consent.

The tools

Tool What it does Spends credits
get_account Balance, plan, price per photo; for live keys the budget and today's spend no
list_models · list_backgrounds · get_photo_options People, places, formats, shot types no
add_product_photos Product photos from public image links no
create_upload_session · get_uploaded_photos Photos from code (presigned PUT) or from a page a person opens no
plan_photos Plans a session; returns the exact price and a quote_id no
generate_photos Launches the planned session yes
get_photo_session Progress and finished photos; can wait until done no
list_recent_photos · cancel_photo_session Recent photos; stop a session (unstarted photos are refunded) refunds
get_docs These pages no

Next: Create photos for the whole workflow, Keys and sign-in for every way to authenticate, Errors for what each error code means.