# Tier Maker List MCP Server

> Free Tier List Maker With Images | Tier Maker List

[![MCP Badge](https://lobehub.com/badge/mcp/rocnubie-tiermakerlist-mcp)](https://lobehub.com/mcp/rocnubie-tiermakerlist-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
[![Read Only](https://img.shields.io/badge/server-read--only-2ea44f)](#tools)
[![Stdio Transport](https://img.shields.io/badge/transport-stdio-6e6e6e)](https://modelcontextprotocol.io/specification)
[![MCP](https://img.shields.io/badge/MCP-1.0-blue)](https://modelcontextprotocol.io)
[![Node](https://img.shields.io/badge/node-%3E%3D18-339933?logo=node.js&logoColor=white)](https://nodejs.org)

A Model Context Protocol server that exposes the canonical Tier Maker List knowledge surface — browser editing workflows, local processing, and safety boundaries, FAQ, official links — to MCP-compatible AI clients such as Claude Desktop, Cursor, Windsurf, and Continue. Read-only, no API keys, no quota, ~50 ms cold start.

Official website: https://tiermakerlist.com

## 🛠️ About Tier Maker List

Tier Maker List is a static, image-first tier list maker that opens directly to a blank board. Visitors can rank images by drag or tap, keep drafts locally without signing up, export a PNG or .tierlist.json file, and prepare a challenge for friends.

The public template catalog currently includes Pokemon Starters Gen 1-9 and Pokemon Starter Evolutions. Built-in sharing uses stable item IDs, a template version, tier, and order; custom images are not embedded in the URL. This MCP describes the editor workflow and template boundaries as read-only context, not as a hosted board or image service.

The site runs in the browser with localStorage for drafts and challenge records. Image sources, character rights, and any commercial use of exported boards require their own review.

## Tools

### `get_editor_scope`
Return the editor workflow and the documented limits on local processing or export. (Tier Maker List)

_Input:_ no parameters. _Returns:_ text/markdown.

### `get_official_links`
Return the canonical list of official links for Tier Maker List (website, support, docs when available).

_Input:_ no parameters. _Returns:_ text/markdown.

## Resources

- `site://tiermakerlist/workbench` — Public editing workflow, local-processing model, and documented safety limits.
- `site://tiermakerlist/faq` — Short FAQ generated from public site metadata.
- `site://tiermakerlist/links` — Canonical URLs to share with users.

## Prompts

### `tell_me_about_tiermakerlist`
Summarize what the site is, who it's for, and how it works. — Tier Maker List

### `review_edit_scope_tiermakerlist`
Review an editing workflow without promising unsupported file mutation. — Tier Maker List

## Installation

### Install via Smithery

```bash
npx -y @smithery/cli install tiermakerlist-mcp --client claude
```

(Replace `claude` with `cursor`, `windsurf`, or `continue` for those clients.)

### Install from source

```bash
git clone https://github.com/rocnubie/tiermakerlist-mcp.git
cd tiermakerlist-mcp
pnpm install
```

Then add to your MCP client config (`claude_desktop_config.json` for Claude Desktop, `mcp.json` for Cursor / Windsurf / Continue):

```json
{
  "mcpServers": {
    "tiermakerlist-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/tiermakerlist-mcp/src/index.mjs"
      ]
    }
  }
}
```

### Debug with MCP Inspector

```bash
npx @modelcontextprotocol/inspector node src/index.mjs
```

## Official Links

- Website: https://tiermakerlist.com

## Development

```bash
pnpm install
pnpm start                 # run the server over stdio
```

## License

MIT