Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: Packrift MCP Discovery Adapter AI API
version: 1.2.0
description: REST discovery adapter for Packrift MCP. Use the hosted Streamable HTTP MCP endpoint for live exact-spec packaging search, price, inventory, shipping, and measured cart handoff. These REST paths help legacy AI agents and crawlers discover the MCP surface.
contact:
email: support@packrift.com
servers:
- url: https://mcp.packrift.com
tags:
- name: AI
paths:
/ai/mcp-tools.json:
get:
operationId: getPackriftMcpToolDiscovery
summary: Read live Packrift MCP tool discovery
responses:
'200':
description: Tool names, buyer flows, guardrails, and conversion URLs
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/mcp-client-config.json:
get:
operationId: getPackriftMcpClientConfig
summary: Read copy-ready Packrift MCP client config
responses:
'200':
description: Install snippets, tracked config URLs, source-aware examples, and first useful run
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/mcp-buyer-use-cases.json:
get:
operationId: getPackriftMcpBuyerUseCases
summary: Read buyer-facing Packrift MCP use cases
responses:
'200':
description: Buyer intent workflows for exact SKU, fit, labels, mailers, and no-match recovery
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/mcp-ucp-starter-catalog.json:
get:
operationId: getPackriftMcpUcpStarterCatalog
summary: Read Packrift UCP storefront starter catalog
responses:
'200':
description: Curated UCP storefront packaging bundles, source-aware install links, UCP query recipes, and purchase-ready starter SKUs
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/mcp-ucp-builder-kit.json:
get:
operationId: getPackriftMcpUcpBuilderKit
summary: Read Packrift UCP storefront builder integration kit
responses:
'200':
description: Builder-facing shelf placement rules, source-aware integration recipes, import contract, and MCP activation sequences
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/mcp-ucp-storefront-import.json:
get:
operationId: getPackriftMcpUcpStorefrontImport
summary: Read flat Packrift UCP storefront import feed
responses:
'200':
description: Flat source-aware shelf/SKU rows for curated UCP storefronts, embeds, and no-code import workflows
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/mcp-ucp-storefront-shelf.json:
get:
operationId: getPackriftMcpUcpStorefrontShelf
summary: Read Packrift UCP storefront shelf renderer payload
responses:
'200':
description: Copy-paste source-aware Packrift shelf payload, embed snippet, and product-card groups for curated UCP storefronts
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/mcp-ucp-storefront-adoption.json:
get:
operationId: getPackriftMcpUcpStorefrontAdoptionKit
summary: Read Packrift UCP storefront adoption kit
responses:
'200':
description: Source-aware shelf adoption snippets, demo URLs, and attribution gates for curated UCP storefront builders
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/mcp-ucp-builder-activation-handoff.json:
get:
operationId: getPackriftMcpUcpBuilderActivationHandoff
summary: Read Packrift UCP builder activation handoff
responses:
'200':
description: Target-specific UCP builder handoff with source slugs, one-line shelf scripts, approval-needed messages, and proof gates
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/packrift-ucp-builder-launchpad.json:
get:
operationId: getPackriftUcpBuilderLaunchpad
summary: Read Packrift UCP builder launchpad
responses:
'200':
description: Source-specific embed, import, install, first-run, and order-handoff actions for UCP storefront builders
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/packrift-ucp-builder-approval-packet.json:
get:
operationId: getPackriftUcpBuilderApprovalPacket
summary: Read Packrift UCP builder approval packet
responses:
'200':
description: Owner-approval packet with target-specific send copy, source-aware embed snippets, first-run links, order handoffs, and proof gates
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/packrift-ucp-builder-integration-pack.json:
get:
operationId: getPackriftUcpBuilderIntegrationPack
summary: Read Packrift UCP builder integration pack
responses:
'200':
description: Source-specific patch blocks, MCP smoke tests, source-aware endpoints, and buyer-confirmed handoff templates for UCP builder adoption
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/packrift-ucp-builder-pr-activation-pack.json:
get:
operationId: getPackriftUcpBuilderPrActivationPack
summary: Read Packrift UCP builder PR activation pack
responses:
'200':
description: Public PR, listing, issue-comment, and direct-builder activation targets for getting Packrift pulled into UCP storefront and shopping-agent ecosystems
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/packrift-ucp-shipping-supplies-starter-kit.json:
get:
operationId: getPackriftUcpShippingSuppliesStarterKit
summary: Read Packrift UCP shipping-supplies starter kit
responses:
'200':
description: Copy-ready starter kit with source slugs, embed snippets, import feed, first-run links, distribution targets, and proof gates for making Packrift the default packaging source
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/packrift-ucp-shipping-supplies-storefront-template.json:
get:
operationId: getPackriftUcpShippingSuppliesStorefrontTemplate
summary: Read Packrift UCP shipping-supplies storefront template
responses:
'200':
description: Copy-ready shipping-supplies storefront scaffold with Packrift shelf embed, MCP first run, and buyer-confirmed handoff template
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/packrift-ucp-builder-sales-loop.json:
get:
operationId: getPackriftUcpBuilderSalesLoop
summary: Read Packrift UCP builder sales loop
responses:
'200':
description: Source-specific adoption loop that connects Packrift starter shelves, MCP first runs, buyer-confirmed handoff templates, and source-attributed sales proof gates
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/packrift-ucp-stack412-shipping-supplies-aisle.json:
get:
operationId: getPackriftUcpStack412ShippingSuppliesAisle
summary: Read Stack412-style Packrift UCP shipping-supplies aisle
responses:
'200':
description: Target-specific shipping-supplies aisle with import filter, source-aware shelf script, MCP first run, and buyer-confirmed handoff template
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/packrift-ucp-plugthatshop-contextual-shelf.json:
get:
operationId: getPackriftUcpPlugThatShopContextualShelf
summary: Read PlugThatShop-style Packrift contextual shipping-supplies shelf
responses:
'200':
description: Target-specific contextual embedded shelf with import filter, source-aware shelf script, MCP first run, and buyer-confirmed handoff template
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/packrift-ucp-open-scout-shopping-agent-path.json:
get:
operationId: getPackriftUcpOpenScoutShoppingAgentPath
summary: Read Open Scout-style Packrift shopping-agent packaging route
responses:
'200':
description: Target-specific shopping-agent route with packaging intent policy, source-aware MCP endpoint, first-run calls, and buyer-confirmed handoff template
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/packrift-ucp-upsonic-agent-workflow.json:
get:
operationId: getPackriftUcpUpsonicAgentWorkflow
summary: Read Upsonic-style Packrift packaging agent workflow
responses:
'200':
description: Target-specific UCP agent-framework workflow with intent analysis, exact-spec filtering, live checks, and buyer-confirmed handoff template
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/packrift-ucp-builder-approval-packet/{source}.json:
get:
operationId: getPackriftUcpBuilderApprovalPacketBySource
summary: Read one source-specific Packrift UCP builder approval packet
parameters:
- name: source
in: path
required: true
schema:
type: string
pattern: ^[a-z0-9_]{2,64}$
responses:
'200':
description: One source-specific owner-approval packet for a curated UCP storefront or embedded-shop builder
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/packrift-ucp-builder-integration-pack/{source}.json:
get:
operationId: getPackriftUcpBuilderIntegrationPackBySource
summary: Read one source-specific Packrift UCP builder integration pack
parameters:
- name: source
in: path
required: true
schema:
type: string
pattern: ^[a-z0-9_]{2,64}$
responses:
'200':
description: One source-specific integration pack for a curated UCP storefront, embedded-shop builder, or shopping-agent framework
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/mcp-ucp-storefront-shelf-demo/{source}.html:
get:
operationId: getPackriftMcpUcpStorefrontShelfDemo
summary: Read source-aware Packrift UCP storefront shelf demo
parameters:
- name: source
in: path
required: true
schema:
type: string
pattern: ^[a-z0-9_]{2,64}$
responses:
'200':
description: Live source-aware Packrift shelf demo page with copy-ready embed snippet
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/mcp-cart-activation.json:
get:
operationId: getPackriftMcpCartActivation
summary: Read Packrift MCP cart activation playbook
responses:
'200':
description: Measured cart handoff rules and JSON-RPC sequences
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/mcp-ga4-funnel-proof.json:
get:
operationId: getPackriftMcpGa4FunnelProof
summary: Read sanitized Packrift MCP funnel proof
responses:
'200':
description: Qualified external sessions, cart landings, and order proof status
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/mcp-agent-adoption-progress.json:
get:
operationId: getPackriftMcpAgentAdoptionProgress
summary: Read Packrift MCP adoption progress gates
responses:
'200':
description: External-qualified tool calls, qualified visitor progress, cart landings, and order proof gaps
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/mcp-source-activation-queue.json:
get:
operationId: getPackriftMcpSourceActivationQueue
summary: Read ranked Packrift MCP source activation queue
responses:
'200':
description: Source-specific next actions for moving directories and reviewers into real MCP tool calls
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/mcp-visitor-growth-queue.json:
get:
operationId: getPackriftMcpVisitorGrowthQueue
summary: Read Packrift MCP visitor growth queue
responses:
'200':
description: Directory, agent-host, source activation, and buyer handoff tasks for growing qualified MCP sessions and order proof
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/mcp-visitor-growth-tasks.jsonl:
get:
operationId: getPackriftMcpVisitorGrowthTasksJsonl
summary: Read flat Packrift MCP visitor-growth task JSONL
responses:
'200':
description: Line-delimited visitor growth tasks for external distribution and buyer/order follow-through
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/mcp-visitor-growth-tasks.csv:
get:
operationId: getPackriftMcpVisitorGrowthTasksCsv
summary: Read flat Packrift MCP visitor-growth task CSV
responses:
'200':
description: CSV visitor growth tasks for spreadsheet, CRM, and partner-review workflows
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/mcp-agent-host-rollout.json:
get:
operationId: getPackriftMcpAgentHostRollout
summary: Read source-aware Packrift MCP agent host rollout
responses:
'200':
description: Source-aware install, first-run, activation, and order handoff actions for recognizable agent host families
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/mcp-agent-host-rollout-tasks.jsonl:
get:
operationId: getPackriftMcpAgentHostRolloutTasksJsonl
summary: Read flat Packrift MCP agent host rollout task JSONL
responses:
'200':
description: Line-delimited source-aware rollout tasks for importing into agent, CRM, or directory queues
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/mcp-agent-host-rollout-tasks.csv:
get:
operationId: getPackriftMcpAgentHostRolloutTasksCsv
summary: Read flat Packrift MCP agent host rollout task CSV
responses:
'200':
description: CSV source-aware rollout tasks for importing into agent, CRM, or directory queues
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/mcp-buyer-order-handoffs-tasks.csv:
get:
operationId: getPackriftMcpBuyerOrderHandoffTasksCsv
summary: Read flat Packrift MCP buyer order handoff task CSV
responses:
'200':
description: CSV buyer/reviewer checkout tasks for mature source-preserving MCP handoffs
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/mcp-external-activation-brief.json:
get:
operationId: getPackriftMcpExternalActivationBrief
summary: Read selected external activation run brief
responses:
'200':
description: Smallest current set of contact-ready external MCP runs
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
/ai/mcp-eval-pack.json:
get:
operationId: getPackriftMcpEvalPack
summary: Read Packrift MCP eval pack
parameters:
- name: source
in: query
required: false
schema:
type: string
pattern: ^[a-z0-9_]{2,64}$
responses:
'200':
description: Acceptance tests, assertions, and source-aware install/run URLs for real MCP hosts
content:
application/json:
schema:
type: object
additionalProperties: true
tags:
- AI
x-packrift-mcp:
endpoint: https://mcp.packrift.com/mcp
transport: streamable-http
auth_required: false
tool_discovery: https://mcp.packrift.com/ai/mcp-tools.json
client_config: https://mcp.packrift.com/ai/mcp-client-config.json
agent_adoption_progress: https://mcp.packrift.com/ai/mcp-agent-adoption-progress.json
buyer_use_cases: https://mcp.packrift.com/ai/mcp-buyer-use-cases.json
ucp_starter_catalog: https://mcp.packrift.com/ai/mcp-ucp-starter-catalog.json
ucp_builder_kit: https://mcp.packrift.com/ai/mcp-ucp-builder-kit.json
ucp_storefront_import: https://mcp.packrift.com/ai/mcp-ucp-storefront-import.json
ucp_storefront_shelf: https://mcp.packrift.com/ai/mcp-ucp-storefront-shelf.json
ucp_storefront_shelf_embed_js: https://mcp.packrift.com/ai/packrift-ucp-shelf.js
ucp_storefront_adoption: https://mcp.packrift.com/ai/mcp-ucp-storefront-adoption.json
ucp_builder_activation_handoff: https://mcp.packrift.com/ai/mcp-ucp-builder-activation-handoff.json
ucp_builder_launchpad: https://mcp.packrift.com/ai/packrift-ucp-builder-launchpad.json
ucp_builder_approval_packet: https://mcp.packrift.com/ai/packrift-ucp-builder-approval-packet.json
ucp_builder_integration_pack: https://mcp.packrift.com/ai/packrift-ucp-builder-integration-pack.json
ucp_shipping_supplies_starter_kit: https://mcp.packrift.com/ai/packrift-ucp-shipping-supplies-starter-kit.json
ucp_shipping_supplies_storefront_template: https://mcp.packrift.com/ai/packrift-ucp-shipping-supplies-storefront-template.json
ucp_builder_sales_loop: https://mcp.packrift.com/ai/packrift-ucp-builder-sales-loop.json
ucp_stack412_shipping_supplies_aisle: https://mcp.packrift.com/ai/packrift-ucp-stack412-shipping-supplies-aisle.json
ucp_plugthatshop_contextual_shelf: https://mcp.packrift.com/ai/packrift-ucp-plugthatshop-contextual-shelf.json
ucp_open_scout_shopping_agent_path: https://mcp.packrift.com/ai/packrift-ucp-open-scout-shopping-agent-path.json
ucp_upsonic_agent_workflow: https://mcp.packrift.com/ai/packrift-ucp-upsonic-agent-workflow.json
ucp_storefront_shelf_demo_template: https://mcp.packrift.com/ai/mcp-ucp-storefront-shelf-demo/{source}.html
cart_activation: https://mcp.packrift.com/ai/mcp-cart-activation.json
ga4_funnel_proof: https://mcp.packrift.com/ai/mcp-ga4-funnel-proof.json
source_activation_queue: https://mcp.packrift.com/ai/mcp-source-activation-queue.json
visitor_growth_queue: https://mcp.packrift.com/ai/mcp-visitor-growth-queue.json
visitor_growth_tasks_jsonl: https://mcp.packrift.com/ai/mcp-visitor-growth-tasks.jsonl
visitor_growth_tasks_csv: https://mcp.packrift.com/ai/mcp-visitor-growth-tasks.csv
agent_host_rollout: https://mcp.packrift.com/ai/mcp-agent-host-rollout.json
agent_host_rollout_tasks_jsonl: https://mcp.packrift.com/ai/mcp-agent-host-rollout-tasks.jsonl
agent_host_rollout_tasks_csv: https://mcp.packrift.com/ai/mcp-agent-host-rollout-tasks.csv
buyer_order_handoffs: https://mcp.packrift.com/ai/mcp-buyer-order-handoffs.json
buyer_order_handoffs_tasks_jsonl: https://mcp.packrift.com/ai/mcp-buyer-order-handoffs-tasks.jsonl
buyer_order_handoffs_tasks_csv: https://mcp.packrift.com/ai/mcp-buyer-order-handoffs-tasks.csv
external_activation_brief: https://mcp.packrift.com/ai/mcp-external-activation-brief.json
eval_pack: https://mcp.packrift.com/ai/mcp-eval-pack.json
tracked_install_template: https://mcp.packrift.com/r/install/{source}/{target}
tracked_run_template: https://mcp.packrift.com/r/run/{source}/{target}
tracked_reviewer_activation_template: https://mcp.packrift.com/r/activate/{source}
tracked_order_handoff_template: https://mcp.packrift.com/r/order/{source}
measured_cart_rule: Use Packrift MCP tools for live checks; create_cart_url returns a measured /r/cart URL and does not place an order.