SUZURI MCP Server

SUZURI MCP Server

日本語版 README はこちら / Japanese README

The official remote Model Context Protocol (MCP) server for SUZURI — a print-on-demand merchandise platform operated by GMO Pepabo, Inc.

Upload images or generate text designs, place them on 450+ items to create original goods, and search and explore products — all through natural language conversations with AI assistants.

Endpoint

https://mcp.suzuri.jp/mcp

Transport: Streamable HTTP. Authentication: OAuth 2.1 (handled automatically by supported clients).

Features

• Material management — upload image materials, generate text materials, analyze reference images, and manage your existing materials
• Product creation — place materials onto items to create products, preview and compare placements, and use placement presets
• Product discovery — search and browse products, view recommendations, similar items, and curated selections
• Favorites & collections — manage favorites and organize products into "Choice" collections
• Account & activity — view your profile, the users you follow, and your activity feed

Pricing: MCP server access is free. Standard SUZURI fees apply when producing or purchasing goods.

Quick Start

Choose your client below.

Claude Code

claude mcp add --transport http suzuri https://mcp.suzuri.jp/mcp

Then run /mcp inside Claude Code and select Authenticate to complete the OAuth flow.

Claude Code MCP docs

Claude Desktop / claude.ai

Settings → Connectors → Add custom connector → enter:

https://mcp.suzuri.jp/mcp

OAuth is handled automatically by Claude.

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "suzuri": {
      "url": "https://mcp.suzuri.jp/mcp"
    }
  }
}

OpenAI Codex CLI

codex mcp add suzuri --url https://mcp.suzuri.jp/mcp

Gemini CLI

See the Gemini CLI MCP server documentation for adding remote MCP servers.

Local stdio bridge (advanced)

For clients that only support stdio transport, use mcp-remote:

{
  "mcpServers": {
    "suzuri": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.suzuri.jp/mcp"]
    }
  }
}

Requirements

• A SUZURI account
• An MCP-compatible client (Claude Desktop, Claude Code, Cursor, OpenAI Codex CLI, Gemini CLI, etc.)

Privacy Policy

• Privacy Policy: GMO Pepabo, Inc. Privacy Policy
• Terms of Service: SUZURI Terms of Service
• Contact: SUZURI contact form

What this server accesses

The server calls the SUZURI API on your behalf using an OAuth 2.1 access token you grant when connecting. Each tool calls one fixed SUZURI endpoint.

• Read — your SUZURI profile, materials, products, sales records, favorites, collections, and activity feed, plus the public catalog (products, users, items).
• Write — only through the write tools you approve: creating and editing materials and products, and managing favorites and collections. This server does not handle purchases or payments; checkout happens on suzuri.jp.
• Image URLs you supply — when you create a material from an image or ask for a reference image to be analyzed, the server fetches that URL so the image can be relayed to SUZURI or inspected.

Storage and retention

Shortened. The full README is on GitHub.