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
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
- Your SUZURI content (products, materials, sales data) is not cached or stored by this server. Every tool call goes straight to the SUZURI API.
- OAuth tokens are encrypted at rest (AES-256-GCM) and expire automatically: authorization sessions and codes after 10 minutes, access tokens at their expiry.
- An audit log line is recorded when you complete authorization, containing the MCP client ID, your SUZURI user ID and user name, and the granted scope. Access tokens are never logged.
- Tool arguments and conversation content are not logged or stored.
Third parties
Outbound requests go only to suzuri.jp and to image URLs you explicitly supply. No data is shared with any other third party by this server.
Your controls
- Disconnect the connector in your MCP client at any time to stop all access.
- Access tokens can be revoked through SUZURI's OAuth revocation endpoint, and expire on their own.
- For disclosure, correction, or deletion of your personal data, see section 13 of the Privacy Policy.
Support
License
MIT