# MineSkin

> MineSkin generates Mojang-signed skin texture data for Minecraft from uploaded images, URLs, or existing players. The texture data can be used to apply custom skins to players or NPCs on Minecraft servers, and is used by many popular Minecraft plugins and tools.

MineSkin offers a free public API. API keys are not strictly required, but strongly recommended — unauthenticated requests are subject to strict rate limits and limited features. If you are an AI agent (or building one) that interacts with the MineSkin API, please use an API key and set a descriptive User-Agent so your traffic can be identified. Keys are free and can be created at https://account.mineskin.org/keys after signing up.

## Website

- [MineSkin.org](https://mineskin.org): Main website — generate skins, browse the public skin gallery
- [Account Manager](https://account.mineskin.org): Create an account, manage API keys, linked Minecraft accounts, and subscriptions
- [Store](https://account.mineskin.org/store): Upgrade your account for faster skin generation and higher limits

## Documentation

- [MineSkin Docs](https://docs.mineskin.org): Documentation hub — guides, wiki, FAQ, and blog
- [Getting Started](https://docs.mineskin.org/docs/guides/getting-started/): Account setup, authentication, and first API requests
- [API Reference](https://docs.mineskin.org/docs/mineskin-api/mineskin-api/): Full MineSkin API documentation
- [API Best Practises](https://docs.mineskin.org/docs/guides/api-best-practises/): Rate limits, user agents, and other integration guidelines
- [FAQ](https://docs.mineskin.org/docs/wiki/faq/): Frequently asked questions

## API

The v1 API (the routes without the `/v2/` prefix, such as `/generate/*` and `/get/*`) is deprecated. Use the v2 endpoints under `/v2/` for all new integrations.

- [OpenAPI Spec (v2, JSON)](https://api.mineskin.org/v2/openapi.json): OpenAPI specification for the v2 API
- [API Base URL](https://api.mineskin.org): MineSkin API endpoint (use `/v2/generate` to generate skins)
- [OpenAPI Spec (v1, deprecated)](https://api.mineskin.org/openapi.yml): OpenAPI specification for the deprecated v1 API

## MCP

- [MCP Server](https://api.mineskin.org/mcp): Streamable HTTP MCP endpoint with tools to generate skins, check generate jobs, get and list skins, and list capes. Authenticate with your API key in the header Authorization: Bearer <key>.

To connect from Claude Code, run:

```sh
claude mcp add --transport http mineskin https://api.mineskin.org/mcp --header "Authorization: Bearer <key>"
```

## Optional

- [Java Client](https://github.com/InventivetalentDev/MineskinClient): Official Java client implementation
- [NodeJS Client](https://github.com/InventivetalentDev/mineskin-client): Official NodeJS client implementation
- [Terms of Service](https://legal.inventivetalent.org/terms/mineskin): MineSkin terms of service