JAEN

Use MCP (advanced)

Create and edit tier lists on this service from Claude Code, Codex, or any MCP-capable client.

What is MCP?

MCP (Model Context Protocol) is a standard way for AI agents to talk to external tools. This service exposes an HTTP-based MCP server; pass a single API token and your AI client can write to your account (create / edit / extend templates, upload images).

Endpoint

Setup

  1. Sign in with Google or GitHub (if not signed in yet).
  2. In the API token section below, press “Generate”. Copy the value immediately — it’s shown only once.
  3. Add the endpoint URL and token to your MCP client’s config file (Claude Code, Codex CLI, etc.).
  4. Restart the client and confirm the tier-list tools appear in its tool list.

API token

Loading...

Client config examples

Claude Code

Add the following entry to your Claude Code MCP config JSON: macOS / Linux at `~/.claude/mcp_settings.json`, Windows at `%USERPROFILE%\.claude\mcp_settings.json` (e.g. `C:\Users\<user>\.claude\mcp_settings.json`). Set TIER_LIST_MCP_TOKEN to the generated token.

{
  "mcpServers": {
    "tier-list": {
      "type": "http",
      "url": "https://<your-host>/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:TIER_LIST_MCP_TOKEN}"
      }
    }
  }
}

Codex CLI

Add the following section to your Codex CLI config file (macOS / Linux: `~/.codex/config.toml`, Windows: `%USERPROFILE%\.codex\config.toml`, e.g. `C:\Users\<user>\.codex\config.toml`). Codex CLI supports HTTP MCP servers natively.

[mcp_servers.tier-list]
type = "http"
url = "https://<your-host>/api/mcp"

[mcp_servers.tier-list.headers]
Authorization = "Bearer ${TIER_LIST_MCP_TOKEN}"

Any other HTTP MCP (JSON-RPC 2.0) client works with the same URL and Authorization header.

Available tools

When you talk to your AI client in natural language, it will pick the right tool and call it automatically.

ToolDescription
create_templateCreate a new tier list (always saved as private)
update_templateReplace one of your tier lists’ contents. Visibility unchanged.
extend_templateMake a derived tier list from a public one. Updates to the original flow through to the derived list.
list_my_templatesList the tier lists you own
delete_templateDelete one of your tier lists. Derived lists become independent.
upload_image_from_urlFetch a public image URL, store it, and return an in-service image URL.
upload_image_dataUpload base64 / data: URL bytes directly (for client-side generated images).

Example prompts

Safety and limits

About image generation

Run image generation (DALL-E, Stable Diffusion, Gemini, etc.) on the client side or through a separate MCP server. Pass the resulting public URL or base64 bytes to upload_image_from_url / upload_image_data, then reference the returned URL inside your template items.

Bulk image generation inside Claude Code / Codex CLI

A useful tier list usually needs tens of images. The right path depends on which client you use.

Codex CLI ships with a built-in image generation tool (image_gen / gpt-image-2) that runs inside the ChatGPT Plus / Pro / Team subscription with no extra billing. Claude Code does not generate images natively, so it relies on an external image-generation MCP server or shell-out API call.

Path 1: Codex CLI built-in image_gen (Codex CLI only, within Plus/Pro)

Codex CLI ships with a built-in image generation tool (image_gen / gpt-image-2) that runs inside your ChatGPT Plus / Pro / Team subscription with no extra billing. No OpenAI Platform API key required.

When prompting, explicitly say "use the built-in image_gen tool" and "do not use the OpenAI Platform API". A vague "generate an image" can trigger Codex to write a Python script that calls the Platform API, which incurs separate API billing.

# Example prompt for Codex CLI (use built-in image_gen)

"Using Codex's built-in image_gen tool (NOT the OpenAI Platform API), generate one square
'anime portrait of <character name>, vivid colors' for each of 15 popular 2024 JRPG
protagonists. Upload each base64 to tier-list via upload_image_data, then build an
S/A/B/C/D template using create_template."

Path 2: add an image-generation MCP server (works for Claude Code and other clients)

Claude Code has no built-in image generator. For both Claude Code and Codex CLI, you can register an image-generation MCP server alongside this service’s MCP. The LLM then runs “generate image → upload to tier-list → build template” in a single prompt. Example combinations:

Add any of these (official or community-built) MCP servers to your Claude Code / Codex CLI config alongside this service. The LLM will automatically chain the image-gen tools with our upload tools.

Path 2: shell out to image generation APIs directly

Both Claude Code and Codex CLI can run shell commands, so you can curl an image API directly and pipe the result into upload_image_data / upload_image_from_url. Lighter weight if you don't want to register another MCP server.

OpenAI Images (gpt-image-2) example — returns base64, fed into upload_image_data.

# Claude Code / Codex CLI 内のシェルで実行（OpenAI Platform API キーが必要、別途課金）
curl -s https://api.openai.com/v1/images/generations \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2","prompt":"anime portrait of Goku, square","size":"512x512","n":1,"response_format":"b64_json"}' \
  | jq -r '.data[0].b64_json' > /tmp/goku.b64

# 取得した base64 を upload_image_data に渡す
cat /tmp/goku.b64

Replicate example — returns a public URL ready for upload_image_from_url.

# Replicate (SDXL Lightning) の例
curl -s https://api.replicate.com/v1/predictions \
  -H "Authorization: Token $REPLICATE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"version":"<model-version-hash>","input":{"prompt":"anime portrait of Goku"}}' \
  | jq -r '.urls.get'   # ポーリングして status=succeeded を待ってから output[0] URL を upload_image_from_url へ
Open account settingsBack to home