> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jabrod.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Art Studio over MCP

> Use Art Studio from Claude, Cursor and other MCP clients.

Art Studio's MCP server is a remote server at:

```text theme={null}
https://jabrod.com/api/mcp/art
```

It speaks Streamable HTTP and answers each request with JSON. Tools act on the boards and media of the account you signed in with, or that owns the API key, and generation spends that account's Art credits, the same as in Art Studio.

## Authentication

There are two ways in. Both send `Authorization: Bearer …` with every request.

### Sign in with Jabrod

Add the server without a key. The first time your client connects, it opens Jabrod's sign-in page, auth.jabrod.com, in your browser: sign in, and allow the app to use your account. The token it gets works only for this server.

In Claude Code:

```bash theme={null}
claude mcp add --transport http jabrod-art https://jabrod.com/api/mcp/art
```

Then run `/mcp` in Claude Code, choose `jabrod-art`, and sign in.

This needs a client that supports MCP authorization. [Sign in with Jabrod](https://docs.jabrod.com/platform/sign-in.md#mcp-clients) explains the flow.

### API key

For clients that can't sign in, make a personal API key at [jabrod.com/app/keys](https://jabrod.com/app/keys). It starts with `jbd_sk_` and is shown once. Send it with every request:

```http theme={null}
Authorization: Bearer jbd_sk_…
```

## Client configuration with an API key

> [tab] Claude Code
>
> ```bash theme={null}
> claude mcp add --transport http jabrod-art https://jabrod.com/api/mcp/art --header "Authorization: Bearer jbd_sk_…"
> ```

> [tab] Cursor
>
> ```json .cursor/mcp.json theme={null}
> {
>   "mcpServers": {
>     "jabrod-art": {
>       "url": "https://jabrod.com/api/mcp/art",
>       "headers": { "Authorization": "Bearer jbd_sk_…" }
>     }
>   }
> }
> ```

> [tab] Claude Desktop
>
> Connect through `mcp-remote`. In **Settings ▸ Developer ▸ Edit Config**:
>
> ```json claude_desktop_config.json theme={null}
> {
>   "mcpServers": {
>     "jabrod-art": {
>       "command": "npx",
>       "args": ["-y", "mcp-remote", "https://jabrod.com/api/mcp/art", "--header", "Authorization:${JABROD_KEY}"],
>       "env": { "JABROD_KEY": "Bearer jbd_sk_…" }
>     }
>   }
> }
> ```

> [tab] Other clients
>
> Any client that supports Streamable HTTP servers with custom headers works. URL `https://jabrod.com/api/mcp/art`, header `Authorization: Bearer jbd_sk_…`.

## Tools

| Tool | Input | Returns |
| - | - | - |
| `get_credits` | none | `{used, limit, left, pro}` |
| `list_models` | none | `{image, video, voice}`: each model's id, label, options and credit price |
| `list_boards` | none | `{boards: [{id, title, updated_at}]}` |
| `get_board` | `board_id` | `{id, title, updated_at, nodes, edges, assets}` |
| `create_board` | `title?` | `{id, title}` |
| `list_assets` | `kind?` (`image`, `video` or `audio`), `limit?` (1 to 60, default 20) | `{assets: [{asset_id, kind, url, prompt?, created_at}]}` |
| `generate_image` | `prompt`, `model?`, `aspect?` (`1:1`, `16:9`, `9:16`, `4:3`, `3:4`), `count?` (1 to 4), `board_id?` | `{assets: [{asset_id, url, kind, name}], credits: {used, limit, left}}` |
| `generate_speech` | `text`, `model?`, `voice?`, `board_id?` | `{asset_id, url, kind, name, credits}` |

### Notes

* Call `list_models` for the model ids, aspects, voices and credit prices you can pass to the generate tools.
* With `board_id`, generated media is also added to that board.
* `get_board` returns each node's `kind`, and its text, prompt or media where it has them. `edges` are `{from, to}` node ids.
* Video generation isn't available over MCP yet.

## Errors

A problem you can fix comes back as a tool result with `isError: true` and Art Studio's own message, for example when you run out of credits. Requests without a valid key get HTTP 401.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.