# Build with your collection

Source: https://holofolder.com/app/docs

The cards you collect. The tools you already use.

Connect Holo Folder to your scripts, integrations and AI assistants. Search the card catalog, work with your binders and wanted lists, and read the price evidence behind your collection.

[
Connect an AI assistant
](https://holofolder.com/app/docs/markdown/mcp)
[
Explore the API
](https://holofolder.com/app/docs/markdown/reference)

## Choose your connection

- [AI & agents](https://holofolder.com/app/docs/markdown/mcp): Connect Claude, ChatGPT, Cursor or Codex through MCP. Sign in with Holo Folder, choose permissions, and start asking.

- [REST API](https://holofolder.com/app/docs/markdown/api-keys): Create a personal API key and make your first request. Use the interactive explorer to build your integration.

## From a question to a working request

Ask an assistant to find cards on your wanted list, or build a script that reads a binder. Both interfaces use the same operation schemas and account permissions.

|              | REST API                                    | MCP                                     |
| ------------ | ------------------------------------------- | --------------------------------------- |
| Best for     | Scripts and custom integrations             | AI assistants and coding agents         |
| Sign in with | A personal API key                          | Your Holo Folder account via OAuth      |
| Get started  | [API keys](https://holofolder.com/app/docs/markdown/api-keys)                  | [AI setup guides](https://holofolder.com/app/docs/markdown/mcp)            |
| Reference    | [Interactive API explorer](https://holofolder.com/app/docs/markdown/reference) | Tool names appear on each endpoint page |

**Developer access**

A current Premium subscription or lifetime licence is required. Signup trials do not include developer access.
Partners follow the paid collection owner's access and current membership.

## Your account stays in your control

Connections start with read permissions. Writes, sharing and partner management need explicit permission. Revoke a key or connected assistant at any time from **Settings → Account → Developer access**.

The [API conventions](https://holofolder.com/app/docs/markdown/contracts) cover pagination, rate limits, safe writes and errors.

## Card data and images

The API exposes the data available in Holo Folder's mirror. Missing data stays missing. Prices include available source, freshness and confidence evidence. Images come only from our Cloudflare R2 mirror; a missing mirrored image is reported as unavailable.

Card data is sourced from TCGdex and the providers identified in each result. Pokémon card images are © The Pokémon Company, Nintendo, Creatures and GAME FREAK. Data licensing does not grant rights to the card artwork.

## Read these docs with an agent

Use [llms.txt](https://holofolder.com/app/docs/llms.txt) as the documentation index, or [llms-full.txt](https://holofolder.com/app/docs/llms-full.txt) to read all guides and endpoint contracts in one request. Every page also has a **View as Markdown** link. These public documents need no authentication.

The [OpenAPI document](https://holofolder.com/app/openapi.json) is the machine-readable REST contract. It includes authentication, parameters, request schemas and documented response statuses. MCP uses the [remote server](https://holofolder.com/app/docs/markdown/mcp) to discover tools directly.