# io.github.patchistry/patchistry-mcp-server

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

- name: io.github.patchistry/patchistry-mcp-server
- version: 0.2.0
- connection class: R0 (autonomous)
- trust: 90/100
- quality: 83/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.patchistry%2Fpatchistry-mcp-server
- tools: https://api.protogrid.dev/v1/servers/io.github.patchistry%2Fpatchistry-mcp-server/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "patchistry-mcp-server": {
      "type": "http",
      "url": "https://patchistry-mcp-server.vercel.app/rpc"
    }
  }
}
```


## Trust

- hygiene: 100
- liveness: 100
- freshness: 65
- provenance: 90
- drivers: +repository +namespace-matches-repo +website +reachable +uptime-100% ~updated-130d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 83/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-03-26; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 71 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_curated_build (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); recommend_build (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_shipping_policy (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 1,154 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: no tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: 100 (weight 15)

- pass `deps.known_vulns`: no known advisory in 72 resolved packages
- n/a `deps.mcp_sdk_version`: the official MCP SDK is not in the dependency graph
- pass `deps.resolvable`: patchistry-mcp-server@0.2.0 resolved: 72 packages

- tools: 6, about 1,154 tokens to load them all
- tool set hash: 2dbadb18b128f7b5d64877be4c0b0c50
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.patchistry/patchistry-mcp-server.svg)](https://protogrid.dev/servers/io.github.patchistry/patchistry-mcp-server)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Dependencies

- npm patchistry-mcp-server@0.2.0: resolved, 71 dependencies

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0.

## Remotes

- https://patchistry-mcp-server.vercel.app/rpc (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

- npm patchistry-mcp-server@0.2.0

## Tools (6)

- `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.
- `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.
- `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.
- `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.
- `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.
- `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.