---
name: photo2skin
description: Photo2Skin's AI tools for Minecraft — make a Minecraft skin from a photo or a description, grab any Java player's skin, search a skin library, make Minecraft-style pixel art from a photo, and turn real places into playable Minecraft worlds. Use when the user wants a Minecraft skin (for playing, or a character for a video or a client), a player's skin, a Minecraft map of a real place, or Minecraft-style pixel art.
---

# Photo2Skin

Photo2Skin is a set of AI tools for Minecraft. Its main one makes real, playable 64x64 Minecraft
skins from a photo or a description. It also grabs any Java player's skin, turns photos into
Minecraft-style pixel art, builds real places as Minecraft worlds (Java and Bedrock), and has a
free skin library. For players and for creators who make Minecraft characters for videos or design
skins for others. Turning a Roblox avatar into a Minecraft skin is on the website, not a tool:
https://app.photo2skin.com/roblox-to-minecraft-skin. Not an official Minecraft product.

## Connect (once)

Add the remote MCP server — the user signs in to Photo2Skin and presses Allow:

```bash
claude mcp add --transport http photo2skin https://mcp.photo2skin.com/mcp
```

Other apps: https://app.photo2skin.com/agents

## Tools

| Tool | Cost | Use |
|---|---|---|
| `search_skins`, `get_skin`, `grab_player_skin` | free | Find skins in the library; read any Java player's current skin |
| `get_account` | free | Credit balance and every price — check before a paid tool |
| `create_skin` | credits | From a `description`, or a photo (`photo`, `photo_url` or `upload_id`) |
| `pixelate_photo` | credits | Photo to Minecraft-style pixel art |
| `create_map` | credits, by area | Latitude/longitude + `size_km2` (0.25 street … 25 city), `edition` |
| `get_job` | free | Poll a `skin_…`, `map_…` or `pixel_…` job; done = image + download link |
| `get_photo_upload_link` | free | When you can't pass the photo yourself: the user uploads it at a link |
| `save_skin`, `publish_skin` | free | Save a PNG to the account; publish to the library only when asked |

## Rules

- Tell the user the price (from `get_account`) before any paid tool.
- Paid tools return a job id within seconds. Poll `get_job` every ~10 s; skins take 30–90 s,
  maps minutes. Pass the same `idempotency_key` when retrying, so nothing is charged twice.
- `INSUFFICIENT_CREDITS`: send the user to https://app.photo2skin.com/pricing. Never try to buy.
- Never publish a skin to the library unless the user asked.

## Without MCP (read-only, no account)

`GET https://app.photo2skin.com/api/library/skins?q=knight` — schema at
`https://app.photo2skin.com/api/openapi.json`.