# tiero.io

> tiero.io is a tier list platform. People rank items from templates (catalogs) into tiers, and every public
> catalog shows a consensus board built from everyone's lists. Data providers publish their own catalogs, sites
> embed boards and the builder, and agents can read and write through the API and the MCP server.

Catalogs, lists and consensus boards are public JSON at the endpoints below. Reads need no key; writes use an API
key (`Authorization: Bearer tiero_sk_...`) created at https://tiero.io/account/api-keys.

## API

- [API v1 reference](https://tiero.io/developers/api): every endpoint lives under https://tiero.io/api/v1/
- [Quickstart](https://tiero.io/developers/quickstart): create a catalog and read its consensus with curl
- [Limits](https://tiero.io/developers/limits): rate limits, sizes and quotas
- Search catalogs: GET https://tiero.io/api/v1/catalogs?q=<terms>
- Read a catalog: GET https://tiero.io/api/v1/catalogs/<owner>/<slug>
- Consensus board: GET https://tiero.io/api/v1/catalogs/<owner>/<slug>/consensus
- Lists for a catalog: GET https://tiero.io/api/v1/lists?catalog=<owner>/<slug>&sort=top

## Catalog spec

- [Catalog spec v1](https://tiero.io/developers/catalog-spec): the JSON format for templates (items, groups, tiers,
  branding, credits). JSON Schema files ship in the `@tiero/spec` npm package.

## CLI

- [tiero CLI](https://tiero.io/developers/cli): `npx @tiero/cli validate catalog.json`, `push` and `whoami`, for
  providers who keep catalogs in a repo.

## MCP

- [Remote MCP server](https://tiero.io/developers/mcp): streamable HTTP at https://tiero.io/mcp with OAuth sign-in. Tools search
  catalogs, read consensus and save tier lists for the signed-in user.

## Embeds

- [Embeds](https://tiero.io/developers/embeds): free read-only boards and the premium embeddable builder.