{
  "markdown": "# SUZURI MCP Server\n\n[日本語版 README はこちら / Japanese README](./README.ja.md)\n\nThe official remote [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for [SUZURI](https://suzuri.jp/) — a print-on-demand merchandise platform operated by [GMO Pepabo, Inc.](https://pepabo.com/)\n\nUpload 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.\n\n## Endpoint\n\n```\nhttps://mcp.suzuri.jp/mcp\n```\n\nTransport: Streamable HTTP. Authentication: OAuth 2.1 (handled automatically by supported clients).\n\n## Features\n\n- **Material management** — upload image materials, generate text materials, analyze reference images, and manage your existing materials\n- **Product creation** — place materials onto items to create products, preview and compare placements, and use placement presets\n- **Product discovery** — search and browse products, view recommendations, similar items, and curated selections\n- **Favorites & collections** — manage favorites and organize products into \"Choice\" collections\n- **Account & activity** — view your profile, the users you follow, and your activity feed\n\nPricing: **MCP server access is free.** Standard SUZURI fees apply when producing or purchasing goods.\n\n## Quick Start\n\nChoose your client below.\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http suzuri https://mcp.suzuri.jp/mcp\n```\n\nThen run `/mcp` inside Claude Code and select **Authenticate** to complete the OAuth flow.\n\n[Claude Code MCP docs](https://docs.anthropic.com/en/docs/claude-code/mcp)\n\n### Claude Desktop / claude.ai\n\nSettings → Connectors → **Add custom connector** → enter:\n\n```\nhttps://mcp.suzuri.jp/mcp\n```\n\nOAuth is handled automatically by Claude.\n\n### Cursor\n\nAdd to `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"suzuri\": {\n      \"url\": \"https://mcp.suzuri.jp/mcp\"\n    }\n  }\n}\n```\n\n### OpenAI Codex CLI\n\n```bash\ncodex mcp add suzuri --url https://mcp.suzuri.jp/mcp\n```\n\n### Gemini CLI\n\nSee the [Gemini CLI MCP server documentation](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md) for adding remote MCP servers.\n\n### Local stdio bridge (advanced)\n\nFor clients that only support stdio transport, use [`mcp-remote`](https://www.npmjs.com/package/mcp-remote):\n\n```json\n{\n  \"mcpServers\": {\n    \"suzuri\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.suzuri.jp/mcp\"]\n    }\n  }\n}\n```\n\n## Requirements\n\n- A [SUZURI](https://suzuri.jp/) account\n- An MCP-compatible client (Claude Desktop, Claude Code, Cursor, OpenAI Codex CLI, Gemini CLI, etc.)\n\n## Privacy Policy\n\n- **Privacy Policy**: [GMO Pepabo, Inc. Privacy Policy](https://pepabo.com/company/privacy/)\n- **Terms of Service**: [SUZURI Terms of Service](https://suzuri.jp/terms)\n- **Contact**: [SUZURI contact form](https://suzuri.jp/contact)\n\n### What this server accesses\n\nThe 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.\n\n- **Read** — your SUZURI profile, materials, products, sales records, favorites, collections, and activity feed, plus the public catalog (products, users, items).\n- **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.\n- **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.\n\n### Storage and retention\n\n- Your SUZURI content (products, materials, sales data) is **not cached or stored** by this server. Every tool call goes straight to the SUZURI API.\n- OAuth tokens are encrypted at rest (AES-256-GCM) and expire automatically: authorization sessions and codes after 10 minutes, access tokens at their expiry.\n- 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.\n- Tool arguments and conversation content are not logged or stored.\n\n### Third parties\n\nOutbound 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.\n\n### Your controls\n\n- Disconnect the connector in your MCP client at any time to stop all access.\n- Access tokens can be revoked through SUZURI's OAuth revocation endpoint, and expire on their own.\n- For disclosure, correction, or deletion of your personal data, see section 13 of the [Privacy Policy](https://pepabo.com/company/privacy/).\n\n## Support\n\n- For service-related inquiries: [SUZURI contact form](https://suzuri.jp/contact)\n- For issues with this repository: please open a [GitHub Issue](https://github.com/pepabo/suzuri-mcp/issues)\n\n## License\n\n[MIT](./LICENSE)\n",
  "bytes": 4994,
  "sha": "f540f40589019de614b7b808d22d171cf1661a250c225714a5ba2ec50bb647ab",
  "repo_slug": "pepabo/suzuri-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_pepabo_suzuri_mcp_0b647cc7/readme"
}