sticker-mcp

MCP server that publishes sticker packs: PNG → visually-lossless HEIC + small HEIC thumbnail, upload to Firebase Storage, and merge into the sticker_categories Remote Config parameter.

Requirements

• Node 18+ (uses global fetch)

• brew install libheif imagemagick (provides heif-enc, magick)

• gcloud authenticated with an account that has access to the target Firebase project (crsel-dev) for both Storage and Remote Config:

  gcloud auth login

  The bearer token comes from gcloud auth print-access-token. The active account must have Storage write + firebaseremoteconfig.* permissions on the project. The Remote Config REST API always requires a quota project — the tools send x-goog-user-project (defaults to project; override with quotaProject if your billing/quota project differs).

Related MCP server: latex-mcp

Install

git clone git@github.com:crsel/stickers-mcp.git ~/stickers-mcp && bash ~/stickers-mcp/install.sh

install.sh (safe to re-run) will:

• verify Node 18+,

• install libheif + imagemagick via Homebrew if missing,

• npm install,

• register the server with Claude Code at user scope (available in all your projects).

Afterwards: run gcloud auth login if prompted, then restart Claude Code.

Manual registration (if you skip the script):

claude mcp add stickers-mcp -s user -- node /absolute/path/to/stickers-mcp/src/index.js

Tools

Conventions

• Verified bucket layout: full sticker = gs://<bucket>/<folder>/<file>.heic (bucket root, no stickers/ prefix); thumbnail = gs://<bucket>/thumbnails/<folder>/<file>.heic. Config url = <folder>/<file>.heic.

• folder (storage subfolder) can differ from the category key — e.g. category key Cut Out, folder Cut Outs.

• Referencing a folder of PNGs mirrors that folder's name into the bucket root: convert_stickers returns suggestedFolder, which you pass to upload_stickers as folder → gs://<bucket>/<folder>/ + thumbnails/<folder>/.

Typical flow (driven by Claude)

1. convert_stickers on the PNG file or folder.

2. inspect_bucket stickers/<existing folder>/ to confirm the layout.

3. upload_stickers (try dryRun first) → collect returned urls.

4. Decide category placement with the user (new vs merge, order).

5. update_sticker_categories dryRun=true → review the diff.

6. update_sticker_categories dryRun=false to publish.