Quickstart

Getting started

Connect any MCP-compatible client to the hosted Widemile MCP and run your first generation in under a minute.

Prerequisites

A Widemile account (OAuth signs you in via Supabase).
An MCP client — Claude.ai, Claude Code, Cursor, or the MCP Inspector.
The hosted MCP URL: https://mcp.wmstudio.io/mcp/.

Connect Claude

Open Claude.ai → Settings → Connectors → Add custom connector.
Paste https://mcp.wmstudio.io/mcp/ into the URL field.
Click Connect and complete the OAuth sign-in (Supabase IdP).
You stay signed in for 90 days; tokens refresh transparently every hour.

Connect Cursor / Claude Code

Drop this into your MCP config — same hosted URL, OAuth handles auth on first call.

mcp.json

{
  "mcpServers": {
    "wmstudio": {
      "url": "https://mcp.wmstudio.io/mcp/",
      "auth": "oauth"
    }
  }
}

Local development (contributors only)

End users do not need this section. It only applies if you are contributing to the MCP server itself. To run the server locally with Redis for OAuth state and job tracking:

python3 -m venv .venv && source .venv/bin/activate
pip install -e '.[dev]'
cp .env.example .env
docker compose up redis -d
PYTHONPATH=. uvicorn src.server:root_app --reload --host 0.0.0.0 --port 8080

Your first tool call

The fastest path: a single studio_generate_image call. It returns a hosted image URL on the Widemile CDN that you can pipe into any other tool.

json

{
  "name": "studio_generate_image",
  "arguments": {
    "prompt": "minimalist product photo of a black ceramic mug, soft daylight",
    "model": "fal-ai/flux-2-pro",
    "aspect_ratio": "4:3"
  }
}

Want to refine? Feed the returned URL into studio_expand_image for composition changes, or into studio_camera_angles for a 9-shot exploration.

Next steps

Browse the tool reference.
Chain calls in workflows.
Map common failures in errors.