MCP (Model Context Protocol) is an open standard that lets AI assistants connect to outside tools. Connect Samsa over MCP and your assistant can generate images and videos, use your trained models, and check credits — right inside a conversation, without you leaving the chat.
Point your MCP client at this address:
https://api.samsa.ai/mcp
That single address is all most clients need — there's nothing to install and no local software to keep running.
The developer docs include step-by-step setup for popular clients, including Claude (web and desktop), ChatGPT, Claude Code, Cursor, VS Code, Windsurf, Codex, n8n, Gemini CLI, and Microsoft Copilot Studio. See Connecting MCP clients for the exact steps per app (opens in a new tab).
Sign in with Samsa (OAuth) — best for interactive apps like Claude and ChatGPT. You sign in with your Samsa account and approve a consent screen; the app handles the connection and you never paste a key. See Authorizing the connection below.
API key — best for developer tools like Claude Code, Cursor, and VS Code. You paste an API key (starting samsa_sk_) into the client's configuration. Create one first — see Creating and managing API keys.
When you connect with OAuth, Samsa shows an "Authorize access" screen that tells you which app is asking, which organization it will use, and exactly what it will be able to do. Review it, and choose Authorize only for apps you trust with your organization. You can cancel any request you don't recognize.
Once connected, your assistant can:
List and view your models — see the trained models available in your organization
Generate images — turn a prompt into images, optionally composing your trained style, object, person, and setting models
Edit images — make prompt-based edits with Magic Edit
Generate videos — from a start frame, from text, or from text styled with your models
Check job status and your credit balance
Generation runs as a background job, so your assistant starts it and then checks back when it's ready.
Anything your assistant creates over MCP uses your organization's credits, exactly like the app and the API. Read-only actions (listing models, checking status or balance) are free. See API usage, credits and rate limits for details.
