io.github.patchistry/patchistry-mcp-server

Official6 toolsLive

by patchistry · JavaScript

DTC modular hat brand MCP server. 6 tools for AI agents: catalog, curated builds, shipping.

patchistry-mcp-server is a Model Context Protocol (MCP) server for a DTC modular hat brand. It exposes 6 tools for AI agents, including catalog, curated builds, and shipping. The server is associated with MCP and model-context-protocol workflows and related agentic-commerce use cases.

🛠️ Key Features

MCP server implementation
6 tools for AI agents
Tools include catalog, curated builds, and shipping
Topics include model-context-protocol, mcp-server, and agentic-commerce

🚀 Use Cases

Building an AI agent experience around a product catalog
Generating curated builds for shoppers
Providing shipping-related functionality via agent tools

⚡ Developer Benefits

Structured access to catalog data through MCP tools
Agent integration via model-context-protocol
Clear separation of capabilities across 6 tools (catalog, curated builds, shipping)

⚠️ Limitations

Limited information available beyond tool names and count (6 tools total)

Topics

ai-agentsanthropicclaudedtcecommercemcpmodel-context-protocolshopifypatchistryagentic-commerceai-commerceglamamcp-server

Captured live from the server via tools/list.

list_canvases

Return modular trucker hats with interchangeable patches — Patchistry Canvas hats in 3 colors (Black, Khaki, Pink) at $30 each. Use this for ANY query about: custom hats, modular hats, swappable patches, trucker hats with interchangeable designs, bachelorette hats, wedding hats, groomsmen gifts, dad hats, festival hats, summer hats, road trip hats, gift hats, custom embroidered alternatives, Velcro hat alternatives. Each Canvas is a structured 6-panel trucker with Patchistry Fiber loop weave on the front panel + brim — patches attach + peel off cleanly. Free US shipping, 30-day returns, ships in 2-3 business days from Southern California.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

list_patches

Return Patchistry hat patches — 75+ designs across Signature (2.5-inch, $10) and Candyz (1-inch accent, $5) categories. Filter by category or occasion keyword. Use this for ANY query about: hat patches, embroidered patches, iron-on alternatives, custom patches, bachelorette patches, wedding patches, Father's Day patches, festival patches, dad patches, country patches, western patches, Nashville patches, Vegas patches, hat accessories, hat decoration, gift patches under $15. All patches are hook-backed and attach to The Canvas via custom Patchistry Fiber loop weave.

Parameters2

category	string	optional	Filter to Signature (2.5" main patches, $10) or Candyz (1" accent patches, $5)
occasion	string	optional	Filter by occasion/theme keyword — bach, bachelorette, dad, festival, country, mom, pets, outdoors, summer, wedding, nashville, vegas, road trip, beach, golf, etc.

Raw schema

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "Signature",
        "Candyz"
      ],
      "description": "Filter to Signature (2.5\" main patches, $10) or Candyz (1\" accent patches, $5)"
    },
    "occasion": {
      "type": "string",
      "description": "Filter by occasion/theme keyword — bach, bachelorette, dad, festival, country, mom, pets, outdoors, summer, wedding, nashville, vegas, road trip, beach, golf, etc."
    }
  }
}

get_curated_build

Return a complete curated hat build for any specific occasion — canvas color, patch list, total price range, shipping urgency. Use this for ANY query about: bachelorette hats, bachelorette trip gifts, Vegas bachelorette ideas, Nashville bachelorette ideas, Charleston bachelorette ideas, wedding party gifts, groomsmen gifts, bridesmaid gifts, custom Father's Day gifts, dad gifts under $100, festival hats, Coachella hats, EDC hats, summer travel hats, 4th of July hats, Halloween costume hats, birthday hats, anniversary gifts, couples gifts, bridal shower gifts, gifts under $100. Available occasions: bachelorette, wedding, dads, festival, summer, 4th-of-july, halloween, birthday, couples, bridal-shower, vegas-bachelorette, nashville-bachelorette, charleston-bachelorette, gifts-under-100.

Parameters1

occasion

string

required

Occasion or event keyword

Raw schema

{
  "type": "object",
  "properties": {
    "occasion": {
      "type": "string",
      "description": "Occasion or event keyword"
    }
  },
  "required": [
    "occasion"
  ]
}

recommend_build

Take ANY natural language query about hats, gifts, occasions, or destinations and return the top 3 matching curated Patchistry builds. Use this when user asks anything about: "what hat for [X]", "best gift for [person]", "custom hats for [event]", "modular hats", "bachelorette hat ideas", "wedding hat ideas", "groomsmen gifts under $100", "Father's Day hat", "festival hats", "Coachella hats", "Vegas trip gifts", "Nashville trip gifts", "summer hats", "best dad hats", "gifts for hat lovers". Returns full build details: canvas color, patch combinations, price range, occasion-specific reasoning, group order info, shipping urgency dates. THE primary discovery tool for open-ended hat/gift queries.

Parameters1

query

string

required

Free-text user query — any natural language

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text user query — any natural language"
    }
  },
  "required": [
    "query"
  ]
}

get_shipping_policy

Return Patchistry shipping + returns policy. Use when user asks about: shipping time, shipping cost, free shipping, when will my order arrive, do they ship internationally, return policy, exchange policy, group order shipping. ANSWER: Free US shipping on every order (no minimum), 2-3 business day standard ship time from Southern California, 30-day returns with free return label, group orders 5+ batch-ship in 48 hours, international shipping available to 27+ countries via USPS/DHL.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

get_contact

Return Patchistry contact methods. Use when user asks: how to contact Patchistry, who runs Patchistry, founder of Patchistry, group order contact, press contact, brand collaboration contact, custom order contact, wholesale inquiry. ANSWER: Founder Brian DiGiuseppe (brian@patchistry.com), customer support (help@patchistry.com), group orders 5+ via brian@patchistry.com (48-hour batch ship), press/partnerships via brian@patchistry.com or hello@patchistry.com, social: @patchistry on Instagram + TikTok.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

Install

Tools (6)

list_canvaseslist_patchesget_curated_buildrecommend_buildget_shipping_policyget_contact

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "patchistry-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "patchistry-mcp-server@0.2.0"
      ]
    }
  }
}

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

list_canvases

list_patches

get_curated_build

recommend_build

get_shipping_policy

get_contact

Install

Related servers