src/mcp/tools/types.ts declares how a tool is defined — name, model- facing description, required scope, zod input/output shapes, read-only annotations — and unwrapUpstream, the single place upstream results become tool outcomes: 401 → UpstreamSessionInvalid, other 4xx → the server's message, 5xx/network → "could not be reached". src/mcp/tools/get-credit-balance.ts fetches credits and the active subscription in parallel and returns structuredContent plus a one-line text rendering. src/mcp/server.ts builds an McpServer for one principal: only tools the principal's scopes cover are registered (tools/list reflects permissions); handlers return structured + text, map ToolFailure to isError results, and report UpstreamSessionInvalid to the handler so the grant can be revoked. When scopes leave nothing to register, the tools capability and an empty tools/list are installed through the public low-level API, so a client sees an empty list rather than "method not found" (the SDK installs its handlers lazily). Tests (11): the tool against a scripted upstream with spec-validated fixtures (text, structure, headers, 401/4xx/5xx mapping); the server driven by the SDK's real Client over an in-memory transport (identity, listing with annotations and output schema, scope hiding, structured call result, session-invalid and unavailable outcomes). Claude-Session: https://claude.ai/code/session_01H3gfN2NCx3hBXSrZXYHUQ3
The IDE for artists.
ArtCraft
ArtCraft is the IDE for interactive AI image and video creation. We turn prompting into crafting, so your ideas become a form of tangible expression and computing. This is Adobe Photoshop for everyone, and we're giving away the source code!
Show, Don't Tell: Advanced Crafting Features
Text-to-image is great, but artists need control. It's important to know what your image will look like before you generate it, and it's vitally important to achieve consistency and repeatability.
Note: all of the above videos were generated for free with Grok Video; the cost to build this README was negligible.
Quick and Easy Prompting
We haven't abandoned text-to-asset generation for quick prototyping and ideation. We support every popular workflow in a first class fashion.
Models and Providers Supported within Artcraft
| Provider | Features |
|---|---|
| Artcraft | Nano Banana, Nano Banana Pro, GPT-Image-1 / 1.5, Seedance 1.0 Lite / 1.5 Pro / 2.0, Seedream 4 / 4.5, Flux 1.1 / Kontext, Veo 2 / 3 / 3.1, Kling 1.6 / 2.1 / 2.5 / 2.6, Sora 2 / Pro, Hunyuan 3d 2 / 3 |
| Grok | Grok Imagine, Grok Video |
| Midjourney | Image Gen (all versions) |
| Sora | Sora 1, Sora 2, GPT-Image-1 |
| WorldLabs | Marble (Gaussian Splat World Generation) |
We're going to be adding the following providers soon: Kling (via Kling website accounts), Google (via API keys), Runway (via website account), Luma (via website account).
We're potentially interested in adding other aggregators for those who already have subscriptions and credits at those providers, for example: OpenArt, FreePik, etc.
Downloads
- Visit our website for the stable Windows and MacOS releases
- Or you can grab a more recent Windows and MacOS build directly
- Linux requires building from source for now

