> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mint.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# AI agent skill

> Install the Mint API workflow for Codex, Claude Code, Cursor, and compatible agents.

The open-source **Mint API** skill teaches coding agents the service-specific generation, review, retry, asset-file, Credits, and rate-limit workflows.

## Install

```bash theme={null}
# Codex
npx skills add mintdotgg/mint-api-skill -a codex -g -y

# Claude Code
npx skills add mintdotgg/mint-api-skill -a claude-code -g -y

# Cursor
npx skills add mintdotgg/mint-api-skill -a cursor -g -y

# All compatible agents detected on this machine
npx skills add mintdotgg/mint-api-skill -g -y
```

The installed skill name is `mint-api`. Set `MINT_API_KEY` in the environment where the agent runs; never paste the key into chat.

## Copyable prompts

```text theme={null}
Use the mint-api skill to add Mint model generation to this app. Use the default auto
workflow, poll the operation with bounded backoff, and retrieve the asset.
```

```text theme={null}
Use the mint-api skill to add review-mode Mint model generation. Stop at preview_ready,
show the Preview, and wait for an explicit approve or revise decision.
```

```text theme={null}
Use the mint-api skill to generate a production Asset Pack, handle partial success, and
download its file manifest with stable filenames. Read the OpenAPI contract
before using any endpoint that is not covered by the skill.
```

```text theme={null}
Use the mint-api skill to inspect my Mint identity and usage, then explain the Credits
and pending reservations before starting any paid generation.
```

## What the skill protects

The skill instructs an agent to avoid printing secrets, respect account ownership, distinguish `auto` from `review`, bound polling and retries, protect uncertain mutation retries when needed, and avoid depending on internal URLs or provider credentials.

It can read [llms.txt](https://docs.mint.gg/llms.txt) when it needs a compact map of the current public documentation, or [llms-full.txt](https://docs.mint.gg/llms-full.txt) when a task needs broader context. It uses the [OpenAPI contract](https://api.mint.gg/openapi.json) as the source of truth for exact endpoints and schemas.

## Advanced and related

### Connect Mint MCP

Mint MCP lets your coding agent create and retrieve assets from your Mint account. Open [mcp.mint.gg](https://mcp.mint.gg), choose your coding agent, then sign in and approve access. The production MCP endpoint is:

```text theme={null}
https://mcp.mint.gg/mcp
```

Keep this connection in the coding agent's MCP configuration, not in your app's browser code.

[Learn more about Mint MCP →](/integrations/mcp)

### Install Mint Three.js Skills

Use Mint Three.js Skills with Mint MCP when you want your coding agent to turn Mint assets into browser-based 3D apps, games, viewers, or walkthroughs.

```bash theme={null}
npx skills add mintdotgg/mint-threejs-skills
```

After installation, ask your agent to use `mint-threejs-skills` and Mint MCP together for the 3D experience.

[Learn more about Mint Three.js Skills →](https://github.com/mintdotgg/mint-threejs-skills)