MCP (Model Context Protocol) is an open standard created by Anthropic that lets AI apps connect to external tools over a common interface. Think of it as “USB-C for AI tools”.
Endpoint
- Transport: HTTP (streamable)
- Auth: OAuth 2.1 with PKCE — no API keys
- Stateless: every request authenticates with a Bearer token
What you can do from your AI
Once connected, your AI has access to 6 tools:
See the full tool reference for details.
Why MCP instead of the API?
You don’t have to choose — the same account, credits, and plan work for both.
How it works
1
Install
Add the MCP server to Claude Code, Cursor, Claude Desktop, or Windsurf with one command.
2
Authenticate
First request triggers an OAuth flow: a browser opens, you sign in to Artificial Studio, approve access. A token is stored locally.
3
Use it
Ask your AI: “Generate an image of a dog surfing”. It discovers the right tool, picks a model, runs it, and shows you the result.
Async generation — important
Image and especially video generation can take seconds to several minutes. The MCP server handles this with an async pattern:generatereturns immediately with ajob_idandstatus: "pending".- Your AI client polls
check_generationwith thatjob_idevery few seconds. - When
status: "success", theoutputfield contains the result URL.
poll_after_seconds as a hint so your AI waits the right amount of time. This prevents HTTP timeouts on long jobs (like Veo 3.1 videos).
See Async & polling for details.
Next steps
Quickstart
Install the MCP server in your AI editor — 60 seconds.
Authentication
How OAuth works and how tokens are stored.
Tool reference
Complete reference of all 6 MCP tools.
Async & polling
How long-running generations work under MCP.