# TryInk MCP Server

> Virtual tattoo placement preview — as an MCP tool for AI agents.

Browse 180+ tattoo designs and render them onto any body photo using the [TryInk](https://tryink.me) public API. No API key required.

## Tools

| Tool | Description |
|------|-------------|
| `list_tattoo_designs` | Browse the gallery filtered by style or body part |
| `render_tattoo_preview` | Composite a design onto a body photo URL, returns a preview image URL |

## Quick start

```bash
pip install mcp httpx
python mcp_server.py
```

## Claude Desktop

Add to `~/.claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "tryink": {
      "command": "python",
      "args": ["/path/to/mcp_server.py"],
      "env": { "TRYINK_API_BASE": "https://tryink.me" }
    }
  }
}
```

## Example usage

Once connected, ask Claude:

> "Show me fine line wrist tattoo designs from TryInk"

> "Render the Fine Line Rose tattoo on this photo: https://example.com/arm.jpg"

## API reference

The MCP server wraps the TryInk public REST API:

- `GET https://tryink.me/api/v1/public/gallery` — list designs
- `POST https://tryink.me/api/v1/public/render` — render preview

Full docs: [tryink.me/api-docs](https://tryink.me/api-docs)

## Environment

| Variable | Default | Description |
|----------|---------|-------------|
| `TRYINK_API_BASE` | `https://tryink.me` | API base URL |

## License

MIT