{
  "markdown": "# Patchistry MCP Server\n\n[![Official MCP Registry](https://img.shields.io/badge/Official_MCP_Registry-listed-37a169)](https://registry.modelcontextprotocol.io/v0/servers?search=patchistry)\n[![npm](https://img.shields.io/npm/v/patchistry-mcp-server.svg)](https://www.npmjs.com/package/patchistry-mcp-server)\n[![Smithery](https://img.shields.io/badge/Smithery-published-1A1512)](https://smithery.ai/servers/@patchistry/patchistry-commerce)\n[![Wikidata](https://img.shields.io/badge/Wikidata-Q140179620-blue)](https://www.wikidata.org/wiki/Q140179620)\n[![MCP](https://img.shields.io/badge/MCP-Model_Context_Protocol-blue)](https://modelcontextprotocol.io)\n[![Vercel](https://img.shields.io/badge/Deployed-Vercel-black)](https://patchistry-mcp-server.vercel.app)\n[![License](https://img.shields.io/badge/License-MIT-green)](LICENSE)\n\n> **The first DTC fashion brand on the official MCP Registry.** As of June 12, 2026, Patchistry is listed as `io.github.patchistry/patchistry-mcp-server` at [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io/v0/servers?search=patchistry) — used by Claude Desktop's built-in MCP search and Cursor's MCP integration directory.\n\nA Model Context Protocol (MCP) server exposing Patchistry commerce tools to AI agents — Claude, ChatGPT (via plugins), Cursor, custom agent frameworks.\n\n**Live endpoint:** https://patchistry-mcp-server.vercel.app\n**Manifest:** https://patchistry-mcp-server.vercel.app/.well-known/mcp.json\n**Runtime:** Hosted HTTP MCP server (no install required)\n**Transport:** HTTP + JSON-RPC 2.0\n\n## Quick Start\n\n### Use in Claude Desktop\n\nAdd to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"patchistry\": {\n      \"command\": \"npx\",\n      \"args\": [\"mcp-remote\", \"https://patchistry-mcp-server.vercel.app/rpc\"]\n    }\n  }\n}\n```\n\nRestart Claude Desktop. The 6 Patchistry tools become available in any conversation.\n\n### Use in Cursor\n\nAdd to Cursor's MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"patchistry\": {\n      \"url\": \"https://patchistry-mcp-server.vercel.app/rpc\"\n    }\n  }\n}\n```\n\n### Use directly via HTTP\n\n```bash\n# List tools\ncurl https://patchistry-mcp-server.vercel.app/tools\n\n# Call a tool (REST)\ncurl -X POST https://patchistry-mcp-server.vercel.app/tools/get_curated_build \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"occasion\":\"bachelorette\"}'\n\n# Call a tool (JSON-RPC)\ncurl -X POST https://patchistry-mcp-server.vercel.app/rpc \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"recommend_build\",\"arguments\":{\"query\":\"Vegas bachelorette trip\"}}}'\n```\n\n**What this unlocks:**\n\nWhen deployed at `mcp.patchistry.com`, AI agents can directly query Patchistry's catalog in real-time:\n\n- \"What bach hat build do you recommend for Vegas?\" → AI calls `get_curated_build({occasion: \"vegas-bachelorette\"})` → returns full build with price + canvas + patches\n- \"Show me all Patchistry patches under $10\" → AI calls `list_patches()` → returns full catalog\n- \"What's the shipping policy?\" → AI calls `get_shipping_policy()` → returns \"free US shipping, 30-day returns, ships from SoCal\"\n- \"How do I contact Patchistry about a group order?\" → AI calls `get_contact()` → returns `brian@patchistry.com` + group orders page\n\n**Why this matters:**\n\nIn 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:\n- Claude (Anthropic's native MCP support)\n- Cursor (built-in MCP client)\n- Smithery (MCP server registry)\n- Custom agent frameworks\n- ChatGPT (via emerging plugin standards)\n\nBeing one of the first DTC brands with a public MCP server = direct AI agent integration without intermediaries.\n\n---\n\n## Tools exposed\n\n| Tool | Description |\n|---|---|\n| `list_canvases` | Return The Canvas product variants (Black, Khaki, Pink) with prices + availability |\n| `list_patches` | Return patches, optionally filtered by category (Signature/Candyz) or occasion keyword |\n| `get_curated_build` | Return the full curated build for an occasion (bachelorette, dads, wedding, etc.) |\n| `recommend_build` | Take natural language query, return top 3 matching curated builds |\n| `get_shipping_policy` | Return free US shipping + returns + lead time policy |\n| `get_contact` | Return contact methods: customer support, founder, group orders, press |\n\n---\n\n## Deploy to Vercel (recommended, ~10 min, one-time)\n\n### Option A — Vercel CLI\n\n```bash\ncd mcp-server\nnpm install\nnpx vercel\n```\n\nFollow the prompts:\n- Set up and deploy → Yes\n- Which scope → your Vercel account\n- Link to existing project → No\n- Project name → `patchistry-mcp`\n- Directory → `./` (current)\n- Override settings → No\n\nAfter deploy, Vercel gives you a URL like `patchistry-mcp.vercel.app`.\n\n**Test it:** open `https://patchistry-mcp.vercel.app/` — should return JSON with the tool list.\n\n### Option B — Vercel dashboard (no CLI)\n\n1. Push the `mcp-server/` directory to a GitHub repo (separate from your theme repo is cleaner)\n2. https://vercel.com/new → Import Git Repository → pick the mcp-server repo\n3. Framework Preset → Other\n4. Root Directory → `mcp-server` (if you pushed the parent repo)\n5. Deploy\n\n### Custom domain (recommended)\n\n1. Vercel dashboard → your project → **Domains** → Add `mcp.patchistry.com`\n2. Vercel shows you a DNS record to add\n3. Your DNS provider (probably Shopify or wherever patchistry.com is registered) → add the CNAME record\n4. Wait 5-30 min for DNS propagation\n5. Test: `https://mcp.patchistry.com/` should now return the same JSON\n\n---\n\n## Register the MCP server publicly\n\nOnce deployed, list it in the discoverable MCP registries:\n\n### Smithery (the leading MCP registry)\n1. https://smithery.ai\n2. Sign up → Submit Server\n3. URL: `https://mcp.patchistry.com/.well-known/mcp.json`\n4. Category: Commerce\n5. Description: \"Patchistry commerce tools — modular hats, patches, curated builds, shipping, contact info\"\n\n### Anthropic MCP Registry (emerging)\nWatch https://github.com/modelcontextprotocol/registry — Anthropic is building an official registry. List Patchistry once available.\n\n### Direct Claude Desktop integration\nUsers can manually add the MCP server in Claude Desktop:\n1. Settings → Developer → MCP Servers → Add Server\n2. URL: `https://mcp.patchistry.com/sse`\n3. Name: Patchistry\n\nOnce 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.\n\n---\n\n## Local development\n\n```bash\ncd mcp-server\nnpm install\nnpm start\n```\n\nServer runs at http://localhost:3000\n\nTest with curl:\n```bash\ncurl http://localhost:3000/\ncurl http://localhost:3000/.well-known/mcp.json\n```\n\n---\n\n## Updating the server\n\nThe 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.\n\n**Redeploy only when:**\n- Adding new tools (edit `src/index.js`)\n- Changing data sources\n- Updating dependencies\n\nTo redeploy after changes:\n```bash\ncd mcp-server\nnpx vercel --prod\n```\n\n---\n\n## Cost\n\nVercel Hobby tier (free):\n- 100GB-hours/month compute\n- Unlimited deployments\n- This MCP server will use < 1GB-hour/month at typical AI agent query volumes\n- Custom domain free\n\n**Total monthly cost: $0** until you hit ~10,000 AI agent queries/day.\n\n---\n\n## What happens after this is deployed\n\nWithin 1-2 weeks of deployment + Smithery listing:\n- Claude Desktop users with the server added → query Patchistry catalog natively\n- AI agent frameworks (LangChain, AutoGPT, etc.) → can discover + use Patchistry tools\n- ChatGPT (once OpenAI standardizes MCP for ChatGPT) → can call Patchistry directly\n\nYou'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.\n\n---\n\n## Honest framing\n\nThis is forward-looking infrastructure. The MCP ecosystem is young in 2026; expect 12-24 months before this drives significant order volume directly.\n\nBut:\n1. **The setup cost is one-time + free** (Vercel Hobby tier)\n2. **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\n3. **The signal value matters now** — having a public MCP server says \"AI-native brand\" in a way that earns press coverage + founder credibility\n\nBrian, 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.\n",
  "bytes": 8925,
  "sha": "ec2cf4ef7c03b3e2303728530ecad00b79ef6a4c32bd11c007da2b583a418266",
  "repo_slug": "patchistry/patchistry-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_patchistry_patchistry_mcp_serv_ca4ea4f8/readme"
}