Patchistry MCP server
✓ VerifiedAllows AI agents to query a modular hat brand's catalog, curated builds, shipping policies, and contact information.
Also known as patchistry/patchistry-mcp-server
- Stars
- 1
- Tools
- 6
- Downloads, 30 days
- —
- Latest version
- 0.2.0
- Last commit
- Jun 15, 2026
- License
- MIT
What is Patchistry MCP?
Patchistry allows AI agents to query a modular hat brand's catalog, curated builds, shipping policies, and contact information. It exposes 6 tools, such as list_canvases, list_patches, get_curated_build.
Summary generated from the project's README
About Patchistry MCP server
Helping AI agents navigate a modular hat brand's catalog is the primary function of this hosted MCP server. It provides a direct interface for tools like Claude Desktop and Cursor to access real-time commerce data without requiring manual installation. By connecting via HTTP and JSON-RPC 2.0, agents can interact with the brand's product ecosystem through a remote endpoint.
Developers and AI users can utilize six specific tools to retrieve information. These include list_canvases for product variants, list_patches for finding specific patches by category or keyword, and get_curated_build for occasion-based recommendations. The server also provides access to get_shipping_policy for logistics details and get_contact for customer support or group order inquiries.
Because the server proxies data from existing Shopify endpoints, the information remains current even without redeployments. This setup allows for natural language queries, such as asking for a specific hat build for a bachelorette trip, to be translated into precise tool calls that return prices, availability, and product details.
Written from the project's README. Every use case is checked against a quote from it.
How to install Patchistry MCP
Formats verified 10 Nov 2026Add to CursorInstall Patchistry MCP in Claude Code
$ claude mcp add patchistry-mcp-server -- npx -y patchistry-mcp-serverInstall Patchistry MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"patchistry-mcp-server": {
"command": "npx",
"args": [
"-y",
"patchistry-mcp-server"
]
}
}
}Install Patchistry MCP in VS Code
.vscode/mcp.json
{
"servers": {
"patchistry-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"patchistry-mcp-server"
]
}
}
}Install Patchistry MCP in VS Code CLI
$ code --add-mcp '{"name":"patchistry-mcp-server","type":"stdio","command":"npx","args":["-y","patchistry-mcp-server"]}'Install Patchistry MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"patchistry-mcp-server": {
"command": "npx",
"args": [
"-y",
"patchistry-mcp-server"
]
}
}
}Install Patchistry MCP in Codex
~/.codex/config.toml
[mcp_servers.patchistry-mcp-server] command = "npx" args = ["-y", "patchistry-mcp-server"]
Install Patchistry MCP in Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"patchistry-mcp-server": {
"command": "npx",
"args": [
"-y",
"patchistry-mcp-server"
]
}
}
}Patchistry MCP tools 6
Detected from the READMElist_canvaseslist_patchesget_curated_buildrecommend_buildget_shipping_policyget_contact
| list_canvases | — | |
| list_patches | — | |
| get_curated_build | — | |
| recommend_build | — | |
| get_shipping_policy | — | |
| get_contact | — |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablepatchistry/patchistry-mcp-server is public and reachablegithub.com/patchistry/patchistry-mcp-server ↗Pass
- Package names this repository as its sourcepatchistry-mcp-server names patchistry/patchistry-mcp-server as sourcenpmjs.com/package/patchistry-mcp-server ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-06-15github.com/patchistry/patchistry-mcp-server ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from patchistry-mcp-serverPass
- No critical advisory in the package or its dependencies72 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-03-26 in 130 msPass
README
View on GitHubPatchistry MCP Server
The first DTC fashion brand on the official MCP Registry. As of June 12, 2026, Patchistry is listed as
io.github.patchistry/patchistry-mcp-serverat registry.modelcontextprotocol.io — used by Claude Desktop's built-in MCP search and Cursor's MCP integration directory.
A Model Context Protocol (MCP) server exposing Patchistry commerce tools to AI agents — Claude, ChatGPT (via plugins), Cursor, custom agent frameworks.
Live endpoint: https://patchistry-mcp-server.vercel.app Manifest: https://patchistry-mcp-server.vercel.app/.well-known/mcp.json Runtime: Hosted HTTP MCP server (no install required) Transport: HTTP + JSON-RPC 2.0
Quick Start
Use in Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"patchistry": {
"command": "npx",
"args": ["mcp-remote", "https://patchistry-mcp-server.vercel.app/rpc"]
}
}
}
Restart Claude Desktop. The 6 Patchistry tools become available in any conversation.
Use in Cursor
Add to Cursor's MCP settings:
{
"mcpServers": {
"patchistry": {
"url": "https://patchistry-mcp-server.vercel.app/rpc"
}
}
}
Use directly via HTTP
# List tools
curl https://patchistry-mcp-server.vercel.app/tools
# Call a tool (REST)
curl -X POST https://patchistry-mcp-server.vercel.app/tools/get_curated_build \
-H "Content-Type: application/json" \
-d '{"occasion":"bachelorette"}'
# Call a tool (JSON-RPC)
curl -X POST https://patchistry-mcp-server.vercel.app/rpc \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"recommend_build","arguments":{"query":"Vegas bachelorette trip"}}}'
What this unlocks:
When deployed at mcp.patchistry.com, AI agents can directly query Patchistry's catalog in real-time:
- "What bach hat build do you recommend for Vegas?" → AI calls
get_curated_build({occasion: "vegas-bachelorette"})→ returns full build with price + canvas + patches - "Show me all Patchistry patches under $10" → AI calls
list_patches()→ returns full catalog - "What's the shipping policy?" → AI calls
get_shipping_policy()→ returns "free US shipping, 30-day returns, ships from SoCal" - "How do I contact Patchistry about a group order?" → AI calls
get_contact()→ returnsbrian@patchistry.com+ group orders page
Why this matters:
In 2026, MCP is becoming the standard interface for AI agents to interact with commerce systems. Brands that publish MCP servers early get cited preferentially by:
- Claude (Anthropic's native MCP support)
- Cursor (built-in MCP client)
- Smithery (MCP server registry)
- Custom agent frameworks
- ChatGPT (via emerging plugin standards)
Being one of the first DTC brands with a public MCP server = direct AI agent integration without intermediaries.
Tools exposed
| Tool | Description |
|---|---|
list_canvases |
Return The Canvas product variants (Black, Khaki, Pink) with prices + availability |
list_patches |
Return patches, optionally filtered by category (Signature/Candyz) or occasion keyword |
get_curated_build |
Return the full curated build for an occasion (bachelorette, dads, wedding, etc.) |
recommend_build |
Take natural language query, return top 3 matching curated builds |
get_shipping_policy |
Return free US shipping + returns + lead time policy |
get_contact |
Return contact methods: customer support, founder, group orders, press |
Deploy to Vercel (recommended, ~10 min, one-time)
Option A — Vercel CLI
cd mcp-server
npm install
npx vercel
Follow the prompts:
- Set up and deploy → Yes
- Which scope → your Vercel account
- Link to existing project → No
- Project name →
patchistry-mcp - Directory →
./(current) - Override settings → No
After deploy, Vercel gives you a URL like patchistry-mcp.vercel.app.
Test it: open https://patchistry-mcp.vercel.app/ — should return JSON with the tool list.
Option B — Vercel dashboard (no CLI)
- Push the
mcp-server/directory to a GitHub repo (separate from your theme repo is cleaner) - https://vercel.com/new → Import Git Repository → pick the mcp-server repo
- Framework Preset → Other
- Root Directory →
mcp-server(if you pushed the parent repo) - Deploy
Custom domain (recommended)
- Vercel dashboard → your project → Domains → Add
mcp.patchistry.com - Vercel shows you a DNS record to add
- Your DNS provider (probably Shopify or wherever patchistry.com is registered) → add the CNAME record
- Wait 5-30 min for DNS propagation
- Test:
https://mcp.patchistry.com/should now return the same JSON
Register the MCP server publicly
Once deployed, list it in the discoverable MCP registries:
Smithery (the leading MCP registry)
- https://smithery.ai
- Sign up → Submit Server
- URL:
https://mcp.patchistry.com/.well-known/mcp.json - Category: Commerce
- Description: "Patchistry commerce tools — modular hats, patches, curated builds, shipping, contact info"
Anthropic MCP Registry (emerging)
Watch https://github.com/modelcontextprotocol/registry — Anthropic is building an official registry. List Patchistry once available.
Direct Claude Desktop integration
Users can manually add the MCP server in Claude Desktop:
- Settings → Developer → MCP Servers → Add Server
- URL:
https://mcp.patchistry.com/sse - Name: Patchistry
Once added, that user's Claude will use Patchistry tools natively — they can ask "what's the bach hat build for Vegas" and Claude pulls live data from your server.
Local development
cd mcp-server
npm install
npm start
Server runs at http://localhost:3000
Test with curl:
curl http://localhost:3000/
curl http://localhost:3000/.well-known/mcp.json
Updating the server
The server proxies to https://patchistry.com/products.json and https://patchistry.com/pages/agents-feed for live data — so you don't need to redeploy when products or builds change. The MCP server is essentially a read-only AI-friendly facade over your existing public Shopify endpoints.
Redeploy only when:
- Adding new tools (edit
src/index.js) - Changing data sources
- Updating dependencies
To redeploy after changes:
cd mcp-server
npx vercel --prod
Cost
Vercel Hobby tier (free):
- 100GB-hours/month compute
- Unlimited deployments
- This MCP server will use < 1GB-hour/month at typical AI agent query volumes
- Custom domain free
Total monthly cost: $0 until you hit ~10,000 AI agent queries/day.
What happens after this is deployed
Within 1-2 weeks of deployment + Smithery listing:
- Claude Desktop users with the server added → query Patchistry catalog natively
- AI agent frameworks (LangChain, AutoGPT, etc.) → can discover + use Patchistry tools
- ChatGPT (once OpenAI standardizes MCP for ChatGPT) → can call Patchistry directly
You'll be one of the earliest DTC brands with a public MCP server. That's a defensible positioning advantage in the AI shopping era — the future where AI agents complete purchases on user behalf will heavily favor brands with MCP-native integrations.
Honest framing
This is forward-looking infrastructure. The MCP ecosystem is young in 2026; expect 12-24 months before this drives significant order volume directly.
But:
- The setup cost is one-time + free (Vercel Hobby tier)
- The defensible positioning is real — Smithery listing + direct Claude Desktop integration puts Patchistry in front of every AI-power-user that builds custom agent workflows
- The signal value matters now — having a public MCP server says "AI-native brand" in a way that earns press coverage + founder credibility
Brian, if you deploy this and list it on Smithery, you're in the top 50 DTC brands worldwide with a public MCP commerce server as of 2026. That's a real moat that takes years to dilute.
Patchistry MCP questions
How do I add Patchistry MCP to Claude Code?
Run claude mcp add patchistry-mcp-server -- npx -y patchistry-mcp-server in your terminal. Add --scope user to make it available in every project.
How do I add Patchistry MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Patchistry MCP provide?
It exposes 6 tools, including list_canvases, list_patches, get_curated_build, recommend_build, get_shipping_policy.
How do I use this server in Claude Desktop?
You can add it to your Claude Desktop configuration file by using the npx mcp-remote command with the Patchistry RPC URL.
Does the server require constant redeployment when products change?
No, the server proxies to existing public Shopify endpoints, so it automatically reflects live data without needing a redeploy.