Packrift MCP Server

Production MCP (Model Context Protocol) server for Packrift exact-spec packaging procurement. Hero use case: find the right packaging supply for a given item, SKU, or reorder need, then confirm live price, inventory, shipping, and cart handoff.

Stack: Cloudflare Workers, TypeScript (strict), Hono, Zod, Streamable HTTP transport
Backing: Shopify Admin GraphQL API (2025-04), store packrift.myshopify.com
Endpoint: POST /mcp, GET /mcp (SSE), GET / (health), GET /.well-known/mcp/server-card.json
Install guide: see llms-install.md for remote MCP client configuration.
Discovery gate: product lookup, reorder, quote, and cart handoff flows are constrained to AI-approved Packrift catalog records where SKU selection is involved.

Remote MCP client setup

The public Packrift endpoint is hosted at:

https://mcp.packrift.com/mcp

MCP clients that support remote HTTP or Streamable HTTP servers can add Packrift with:

{
  "mcpServers": {
    "packrift": {
      "type": "http",
      "url": "https://mcp.packrift.com/mcp"
    }
  }
}

Container Image

The public hosted endpoint above is the primary integration path. A container image is published for MCP directories and local environments that require a package-style install surface:

docker pull ghcr.io/packrift/packrift-mcp:latest
docker run --rm -p 8787:8787 \
  -e SHOPIFY_PACKRIFT_TOKEN=... \
  ghcr.io/packrift/packrift-mcp:latest

You can also build the image from this repository:

docker build -t packrift-mcp .
docker run --rm -p 8787:8787 \
  -e SHOPIFY_PACKRIFT_TOKEN=... \
  packrift-mcp

Optional environment variables:

PORT defaults to 8787
SHOPIFY_STORE_DOMAIN defaults to packrift.myshopify.com
SHOPIFY_API_VERSION defaults to 2025-04
STOREFRONT_DOMAIN defaults to packrift.com

The container uses an in-memory cache instead of Cloudflare KV. It is intended for discovery and client testing; the production server remains the Cloudflare Workers endpoint at https://mcp.packrift.com/mcp.

AI Discovery Surfaces

llms.txt: https://mcp.packrift.com/llms.txt
llms-full.txt: https://mcp.packrift.com/llms-full.txt
MCP server card: https://mcp.packrift.com/.well-known/mcp/server-card.json
AI corpus sitemap: https://mcp.packrift.com/ai/sitemap.xml
AI-approved product JSONL: https://mcp.packrift.com/ai/packrift-ai-approved-products.jsonl
AI purchase paths JSONL: https://mcp.packrift.com/ai/purchase-paths.jsonl
Reorder by SKU corpus: https://mcp.packrift.com/ai/reorder-by-sku.md
Top 1,000 AI-sales SKU sitemap: https://mcp.packrift.com/ai/top-1000-ai-sales-sitemap.xml
All AI-approved SKU sitemap: https://mcp.packrift.com/ai/all-ai-approved-sku-sitemap.xml
OpenAI-shaped strict product TSV: https://mcp.packrift.com/ai/packrift-openai-products-strict-stable-current.tsv
Shopify native UCP guide: https://mcp.packrift.com/ai/shopify-native-ucp-commerce-surface.md
Example SKU markdown page: https://mcp.packrift.com/ai/sku/1066.md
Example SKU JSON record: https://mcp.packrift.com/ai/sku/1066.json

Tools

Tools are framed around exact-spec procurement, not generic browsing. Use find_packaging_for_item when the buyer has item dimensions or a fit question; use SKU and exact-spec tools when the buyer is replenishing a known product.

Tool	Purpose
`find_packaging_for_item(dims, weight, use_case)`	Hero. Item L/W/D + weight + use case -> ranked packaging SKUs that fit. Use for smallest-fit, box-vs-mailer, and Uline-by-size style questions.
`search_products(query, limit?)`	Keyword fallback when dimensions are unknown, such as kraft tape, bubble mailer, starter kit, or weather-resistant labels. Cached 5 min in KV.
`get_product(handle)`	Full product detail including variants, dimensions/metafields, weight, stock, and product URL.
`get_pricing(variant_ids[], quantity?)`	Live unit price and line total before purchase handoff. Never cached.
`check_inventory(variant_ids[])`	Live inventory check before recommending or building a cart. Never cached.
`get_shipping_estimate(zip, country, items[])`	Carrier rates for a chosen cart via Shopify `draftOrderCalculate`.
`create_cart_url(items[], discount_code?, ref?)`	Final cart handoff. Builds a `packrift.com/cart/...` permalink with `ref=mcp` and AI-commerce attribution fields.
`get_reorder_link(sku, handle?)`	Reorder URL, product URL, and copy-procurement-spec text for an AI-approved SKU or handle.
`get_bulk_quote_link(requested_spec, family?, sku?, quantity?)`	Tracked bulk quote URL for no-exact-match, large-volume, or procurement-review workflows.
`explain_no_exact_match(requested_spec, missing_or_mismatched_fields?)`	Explains why a nearby product should not be presented as exact, then routes to safe next actions and quote recovery.

MCP Prompts And Resources

The server advertises prompts and resources in addition to tools.

Prompts:

find_exact_packaging_spec
reorder_packrift_sku
request_bulk_quote_for_no_match
copy_procurement_spec
find_box_by_lwh
find_label_by_size_material_printer

Resources include the AI-approved product corpus, per-SKU markdown/JSON records, purchase-path JSONL, exact-spec family files, no-exact-match policy, crawler-safe purchase paths, and the Shopify-native UCP commerce surface.

Exact-spec AI-commerce examples

Packrift is optimized for exact-spec packaging procurement: agents should not treat nearby sizes, materials, colors, adhesives, strength ratings, or case counts as exact substitutes. If there is no exact AI-approved match, route the buyer to reorder, no-match explanation, or bulk quote recovery instead of forcing a substitute.

Current paid ChatGPT / product-card order families that are represented in the public corpus:

SKU 1066: 10 x 6 x 6 ECT-32 kraft corrugated boxes, 25/bundle
SKU MFL1295: 12 1/8 x 9 1/4 x 5 white self-seal literature mailers, 50/pack
SKU LL251WR: 2 5/8 x 1 weather-resistant polyester laser labels, 3000/case

Local development

Install Node 24+ and the deps:

cd ~/Downloads/packrift-mcp-server
npm install

Local secrets — already created at .dev.vars (gitignored):

SHOPIFY_PACKRIFT_TOKEN=shpat_...

Run the server:

npx wrangler dev --port 8787 --local

Smoke-test the MCP endpoint with curl:

# initialize
curl -s -X POST http://127.0.0.1:8787/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'

# list tools
curl -s -X POST http://127.0.0.1:8787/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# search
curl -s -X POST http://127.0.0.1:8787/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_products","arguments":{"query":"poly mailer","limit":3}}}'

Type-check:

npx tsc --noEmit

Deployment

The Cloudflare account is being created in a separate process. Once it's ready and wrangler is logged in (wrangler login), run these in order:

cd ~/Downloads/packrift-mcp-server

# 1. Create the KV namespace and copy the printed id into wrangler.toml
#    (replace both `id` and `preview_id` with the same value).
npx wrangler kv namespace create CATALOG_CACHE

# 2. Set the Shopify Admin token as a secret (paste shpat_... when prompted).
npx wrangler secret put SHOPIFY_PACKRIFT_TOKEN

# 3. Deploy. Initial deploy puts the worker on
#    https://packrift-mcp.<account>.workers.dev
npx wrangler deploy

# 4. (Once mcp.packrift.com is CNAME'd to the worker) uncomment the [[routes]]
#    block in wrangler.toml and redeploy.
npx wrangler deploy

After deploy, the MCP endpoint is https://packrift-mcp.<account>.workers.dev/mcp (and later https://mcp.packrift.com/mcp). The server card lives at /.well-known/mcp/server-card.json.

Design notes / caveats

cartCreate is a Storefront API mutation, not Admin. The brief asked for cartCreate + cartBuyerIdentityUpdate for shipping rates, but those don't exist on the Admin GraphQL API this server uses. The supported Admin path is draftOrderCalculate, which is what get_shipping_estimate uses. It returns the same carrier-rate data without creating a real order.
Dimensions parsing. Packrift product dimensions live in custom.specN_value metafields where the matching custom.specN_name says "Dimensions" or "Size". Format is human-readable (12 1/8" L x 11 5/8" W x 2 5/8" H). src/dimensions.ts parses mixed fractions and falls back to scanning the title.
Recommend collections. The brief mentioned mailer-boxes collection — that handle does not exist on the live store. We use mailers-envelopes, boxes-mailers, corrugated-boxes, bubble-wrap-foam, cushioning, and ecommerce-fulfillment (verified via collections query 2026-04-29).
Use case mapping is in src/tools/recommend_packaging.ts (COLLECTIONS_BY_USE_CASE).
Shipping rate handle in the response is a long opaque JWT-style string — that's how Shopify returns rate handles; pass it through to subsequent calls if needed.
Errors: tool exceptions are returned as { content: [...], isError: true } per the MCP spec, not as JSON-RPC -3260x errors. Protocol-level errors (unknown tool, bad JSON) do return JSON-RPC errors.

File map

src/
  index.ts                       Hono app + MCP JSON-RPC dispatcher
  shopify.ts                     Admin GraphQL client + id helpers
  dimensions.ts                  Spec-string -> structured dimensions
  server-card.ts                 /.well-known card
  tools/
    search_products.ts
    get_product.ts
    get_pricing.ts
    check_inventory.ts
    recommend_packaging.ts
    get_shipping_estimate.ts
    create_cart_url.ts
wrangler.toml                    Worker config (KV binding, vars, route)
package.json
tsconfig.json
.dev.vars                        Local-only secrets (gitignored)

AI Sales SKU Discovery Pages

Packrift publishes AI-commerce SKU pages for exact-spec procurement agents.

Top 1,000 AI SKU sitemap: https://mcp.packrift.com/ai/top-1000-ai-sales-sitemap.xml
SKU markdown template: https://mcp.packrift.com/ai/sku/1066.md
SKU JSON template: https://mcp.packrift.com/ai/sku/1066.json
Reorder corpus: https://mcp.packrift.com/ai/reorder-by-sku.md
AI-approved product JSONL: https://mcp.packrift.com/ai/packrift-ai-approved-products.jsonl

Each SKU page links to the canonical Packrift product page, reorder path, bulk quote path, MCP endpoint, and no-exact-match policy. Use these pages only for AI-approved products and confirm live price and inventory through the MCP tools before checkout handoff.

Name		Name	Last commit message	Last commit date
Latest commit History 15 Commits
.github/workflows		.github/workflows
assets		assets
docs/packaging-reference		docs/packaging-reference
src		src
.dockerignore		.dockerignore
.gitignore		.gitignore
Dockerfile		Dockerfile
LICENSE		LICENSE
PACKRIFT-PACKAGING-REFERENCE.md		PACKRIFT-PACKAGING-REFERENCE.md
README.md		README.md
llms-install.md		llms-install.md
package-lock.json		package-lock.json
package.json		package.json
server.json		server.json
tsconfig.build.json		tsconfig.build.json
tsconfig.json		tsconfig.json
wrangler.toml		wrangler.toml

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Packrift MCP Server

Remote MCP client setup

Container Image

AI Discovery Surfaces

Tools

MCP Prompts And Resources

Exact-spec AI-commerce examples

Local development

Deployment

Design notes / caveats

File map

AI Sales SKU Discovery Pages

About

Uh oh!

Releases 1

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

Packrift MCP Server

Remote MCP client setup

Container Image

AI Discovery Surfaces

Tools

MCP Prompts And Resources

Exact-spec AI-commerce examples

Local development

Deployment

Design notes / caveats

File map

AI Sales SKU Discovery Pages

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages