Skip to content
MCP server

Tattoo Brief MCP

Offline tattoo planning tools: briefs, small-size legibility checks and line-art prompts

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.1.0
Listing updated
2 days ago

About Tattoo Brief MCP

Tattoo Brief MCP is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

Three deterministic tools help someone prepare for a conversation with a tattoo artist. Given the same input, they always return the same output, and no API keys are needed.

build_tattoo_brief takes an idea, style, placement and size in centimetres, with optional colour, must-include and avoid lists, and returns a Markdown brief with placement notes and questions for the artist. check_small_size_legibility takes a size and a list of detail types such as fine lines, small text, dotwork or white ink and returns a blur risk per detail with a suggested minimum size. line_art_prompt turns a subject into a clean line-art prompt and a negative prompt for an image generator.

The README says the legibility check is only a rule of thumb, not a guarantee about healing or ageing, and not medical advice. It runs locally over stdio from a bundled release or built with npm, is MIT licensed, and is maintained by the team behind the Tatany tattoo design site.

Install

Run in a terminal

claude mcp add tattoo-brief-mcp -- npx -y https://github.com/MazzaWill/tattoo-brief-mcp/releases/download/v0.1.0/server.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "tattoo-brief-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/MazzaWill/tattoo-brief-mcp/releases/download/v0.1.0/server.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tattoo-brief-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/MazzaWill/tattoo-brief-mcp/releases/download/v0.1.0/server.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "tattoo-brief-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/MazzaWill/tattoo-brief-mcp/releases/download/v0.1.0/server.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "tattoo-brief-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/MazzaWill/tattoo-brief-mcp/releases/download/v0.1.0/server.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "tattoo-brief-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/MazzaWill/tattoo-brief-mcp/releases/download/v0.1.0/server.mcpb"
      ]
    }
  }
}

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

build_tattoo_brief
Build a Markdown brief from idea, style, placement and size.
check_small_size_legibility
Per-detail blur risk and suggested minimum size.
line_art_prompt
Produce a line-art prompt and negative prompt for a subject.

What it does

Artist-ready brief
Builds a Markdown brief with placement notes and questions to ask.
Size legibility check
Rates blur risk for details at a given size.
Line-art prompts
Produces a prompt and negative prompt for AI image tools.
Deterministic output
The same input always gives the same result.
Local and keyless
Runs over stdio with no API keys.

Good for

  • Prepare a brief before a first tattoo consultation
  • Test whether fine details survive at a small size
  • Write a prompt for a flash-style line drawing
  • Compare placements for the same idea

Pricing

Open source

MIT licensed; the Tatany site has separate paid plans

Prices change. Check tatany.app before you buy.

Tattoo Brief MCP FAQ

Does it call an AI model?

No. All three tools are deterministic rules.

Is the legibility advice reliable?

It uses simple rules of thumb and is not a guarantee about healing or ageing; the artist has the final say.

Is it free?

Yes, it is MIT licensed.

Does it need keys?

No.

Is Tattoo Brief MCP free?

Yes. Tattoo Brief MCP is open source, so you can use and self-host it for free.

How do I add Tattoo Brief MCP to Claude Code?

Run this command in your terminal: claude mcp add tattoo-brief-mcp -- npx -y https://github.com/MazzaWill/tattoo-brief-mcp/releases/download/v0.1.0/server.mcpb

What are the best alternatives to Tattoo Brief MCP?

The closest alternatives to Tattoo Brief MCP are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

Alternatives to Tattoo Brief MCP

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. Eikino

    MCP server

    Estimate where photos or video frames were taken and check media for AI generation

    • 3 tools
    • Remote
    • Freemium
    • Security