Docs / Get started
Artifex Studio documentation
4 minute read · Updated 2026-09-11
Artifex Studio is the visual production layer after the song. Everything the web app can do is also available to an MCP client, so you can run the studio from Claude, Cursor, or your own code — with the same tenancy, credits, and plan limits.
What this covers
These pages document the programmatic surface of Artifex Studio: the remote MCP server, the tool registry behind it, the asynchronous job model every render goes through, and the credit accounting that applies whether work is started from the app or from an agent.
If you are looking for craft guidance — what makes a lyric video hold attention, how long a Short should run, how to plan a release — that lives in the field notes rather than here.
| Page | What it answers |
|---|---|
| Core concepts | The objects — artists, songs, media assets, artstyles, jobs — and how they relate. |
| MCP overview | What the server exposes, the transport, and how a request is authorised. |
| Connect a client | Copy-paste setup for Claude Code, Claude Desktop, Cursor, and raw HTTP. |
| Authentication | Minting, rotating, and revoking the per-workspace bearer token. |
| Toolsets | The nine folders, and progressive disclosure for small context windows. |
| Agent Skill | A downloadable skill that teaches any compatible AI agent to use this API properly. |
| Tool reference | Every tool, generated from the running registry. |
| Jobs | How renders are launched, polled, and cancelled. |
| Credits and limits | What costs credits, and what happens at the edges. |
| Troubleshooting | Errors you will actually hit, and what each one means. |
What Studio does
You bring a finished track. Studio turns it into the release system around that track: cover art and artist imagery, lyric-led and generated video, and social-ready copy — held together by a reusable visual identity so a release looks like one body of work rather than ten unrelated posts.
- Cover art and artist imagery, generated against a saved artstyle.
- Lyric videos, cut to sections you choose on the waveform.
- Short-form video from stills, from raw clips, or from the full studio pipeline.
- Full-length YouTube renders — static or subtly animated.
- Content ideas and per-platform post copy drawn from the artist’s brand guide.
Your first call
If you already have a token, this is the shortest path to proving the connection works. It calls the one tool that needs no arguments and touches no data.
curl -s https://app.artifexstudio.app/api/mcp \
-H "Authorization: Bearer $ARTIFEX_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": { "name": "health_check", "arguments": {} }
}'No token yet? Start at Authentication — it takes about a minute, and requires a Pro or Studio plan.
Keep going