SUZURI MCP Server

io.github.pepaboPublished by GitHub account pepabov0.4.0Updated Nov 2, 2026

Official remote MCP server for SUZURI.

The publisher's own server: Suzuri

VerifiedStreamable HTTPWeb executableBusiness & CommerceMedia & Design

Overview

AI-generated overview

Official remote SUZURI MCP server that lets an assistant create print-on-demand goods, manage materials, and browse products via OAuth.

What you can do
  • Upload image materials, generate text designs, analyze reference images, and manage existing materials
  • Place materials on 450+ items to create products, preview and compare placements, and use placement presets
  • Search and browse products, view recommendations, similar items, and curated selections
  • Manage favorites and organize products into "Choice" collections
  • View your profile, followed users, and activity feed
When to use it
Useful when you want an AI assistant to design and produce original merchandise on SUZURI, or to explore and organize SUZURI products, without leaving the chat.
Requirements
A SUZURI account and an MCP-compatible client that supports remote Streamable HTTP with OAuth 2.1; clients limited to stdio can bridge through mcp-remote. No API keys or environment variables are needed.
Before you install
The server acts on your SUZURI account with an OAuth token and can create or edit materials and products and change favorites and collections. It does not handle purchases or payments; checkout happens on suzuri.jp, where standard SUZURI fees apply. Image URLs you supply are fetched by the server and relayed to SUZURI.

Installation

In SourceWeft

  1. Open SUZURI MCP Server in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.pepabo%2Fsuzuri-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

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

README

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

bash
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:

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

OpenAI Codex CLI

bash
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:

json
{  "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

Source: README.md at commit 852fdc6

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v0.4.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Suzuri integrations

Suzuri

dev.suzuriOfficial publisher

A remote MCP server that lets an assistant run semantic searches across Japan's official government white papers in English or Japanese.

Streamable HTTPWeb executable
Web Search & Scraping1 toolOct 25, 2026