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.)

Support

• For service-related inquiries: SUZURI
• For issues with this repository: please open a GitHub Issue

License

MIT