# Ink Studio AI MCP server

> Generate custom tattoo designs in various styles and search a public gallery using AI agents.

- Repository: https://github.com/ciroartz/inkstudioai-cli
- Page: https://hostedmcp.org/servers/ciroartz/inkstudioai-cli
- Transport: stdio
- Stars: 1
- License: MIT
- Latest version: 0.1.1

## Install

### Claude Code

```sh
claude mcp add --env INKSTUDIO_API_KEY=<YOUR_INKSTUDIO_API_KEY> inkstudioai-cli -- npx -y inkstudioai
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "inkstudioai-cli": {
      "command": "npx",
      "args": [
        "-y",
        "inkstudioai"
      ],
      "env": {
        "INKSTUDIO_API_KEY": "<YOUR_INKSTUDIO_API_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "inkstudioai-cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "inkstudioai"
      ],
      "env": {
        "INKSTUDIO_API_KEY": "<YOUR_INKSTUDIO_API_KEY>"
      }
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "inkstudioai-cli": {
      "command": "npx",
      "args": [
        "-y",
        "inkstudioai"
      ],
      "env": {
        "INKSTUDIO_API_KEY": "<YOUR_INKSTUDIO_API_KEY>"
      }
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.inkstudioai-cli]
command = "npx"
args = ["-y", "inkstudioai"]

[mcp_servers.inkstudioai-cli.env]
INKSTUDIO_API_KEY = "<YOUR_INKSTUDIO_API_KEY>"
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "inkstudioai-cli": {
      "command": "npx",
      "args": [
        "-y",
        "inkstudioai"
      ],
      "env": {
        "INKSTUDIO_API_KEY": "<YOUR_INKSTUDIO_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `INKSTUDIO_API_KEY` | no | yes | Ink Studio AI API key (isk_...). Optional: without it, call the login tool to sign in. |

## FAQ

### Can I try the service for free?

Yes, new accounts receive one free design without needing a credit card.

### What styles of tattoos can I generate?

You can create designs in 13 different styles, including fine line, Japanese, traditional, and realism.

### How do I use this with an AI agent like Claude or Cursor?

You can run the MCP server using npx and provide an API key via an environment variable, or use the login tool within the chat to authenticate.
