{
  "openapi": "3.1.0",
  "info": {
    "title": "Packrift MCP Discovery Adapter",
    "version": "0.2.13",
    "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": "farhan@packrift.com"
    }
  },
  "servers": [
    {
      "url": "https://mcp.packrift.com"
    }
  ],
  "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",
    "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."
  },
  "paths": {
    "/mcp": {
      "post": {
        "operationId": "callPackriftMcpJsonRpc",
        "summary": "Call Packrift MCP JSON-RPC",
        "description": "Use JSON-RPC methods such as tools/list, tools/call, resources/list, resources/read, and prompts/list against the hosted Streamable HTTP MCP endpoint.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "jsonrpc",
                  "method"
                ],
                "additionalProperties": true,
                "properties": {
                  "jsonrpc": {
                    "type": "string",
                    "enum": [
                      "2.0"
                    ]
                  },
                  "id": {
                    "oneOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "method": {
                    "type": "string",
                    "examples": [
                      "tools/list",
                      "tools/call",
                      "resources/list",
                      "resources/read",
                      "prompts/list"
                    ]
                  },
                  "params": {
                    "type": "object",
                    "additionalProperties": true
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "MCP JSON-RPC response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/health": {
      "get": {
        "operationId": "getPackriftMcpHealth",
        "summary": "Read Packrift MCP health",
        "responses": {
          "200": {
            "description": "Health, version, tool count, resource count, and KV status",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/manifest": {
      "get": {
        "operationId": "getPackriftMcpManifest",
        "summary": "Read Packrift MCP REST manifest",
        "responses": {
          "200": {
            "description": "Packrift MCP manifest and discovery URLs",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/resources": {
      "get": {
        "operationId": "listPackriftMcpResources",
        "summary": "List Packrift MCP resources",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated Packrift MCP resource list",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/products/{handle_or_sku}": {
      "get": {
        "operationId": "getPackriftProductResource",
        "summary": "Read one AI-approved Packrift product resource",
        "parameters": [
          {
            "name": "handle_or_sku",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "AI-approved Packrift product resource",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/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
                }
              }
            }
          }
        }
      }
    },
    "/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
                }
              }
            }
          }
        }
      }
    },
    "/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
                }
              }
            }
          }
        }
      }
    },
    "/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
                }
              }
            }
          }
        }
      }
    },
    "/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
                }
              }
            }
          }
        }
      }
    },
    "/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
                }
              }
            }
          }
        }
      }
    },
    "/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
                }
              }
            }
          }
        }
      }
    },
    "/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
                }
              }
            }
          }
        }
      }
    },
    "/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
                }
              }
            }
          }
        }
      }
    },
    "/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
                }
              }
            }
          }
        }
      }
    },
    "/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
                }
              }
            }
          }
        }
      }
    },
    "/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
                }
              }
            }
          }
        }
      }
    },
    "/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
                }
              }
            }
          }
        }
      }
    },
    "/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
                }
              }
            }
          }
        }
      }
    },
    "/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
                }
              }
            }
          }
        }
      }
    },
    "/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
                }
              }
            }
          }
        }
      }
    },
    "/r/config/{source}": {
      "get": {
        "operationId": "getPackriftSourceAwareMcpConfig",
        "summary": "Read source-aware MCP client config",
        "parameters": [
          {
            "name": "source",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[a-z0-9_]{2,64}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Source-preserving MCP client config",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/r/install/{source}/{target}": {
      "get": {
        "operationId": "getPackriftSourceAwareInstallAction",
        "summary": "Read source-aware install action",
        "parameters": [
          {
            "name": "source",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[a-z0-9_]{2,64}$"
            }
          },
          {
            "name": "target",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Target-specific install command or config that preserves source attribution",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/r/run/{source}/{target}": {
      "get": {
        "operationId": "getPackriftSourceAwareFirstRun",
        "summary": "Read source-aware first useful run",
        "parameters": [
          {
            "name": "source",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[a-z0-9_]{2,64}$"
            }
          },
          {
            "name": "target",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Source-aware first-run action payload",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/r/activate/{source}": {
      "get": {
        "operationId": "getPackriftSourceAwareReviewerActivation",
        "summary": "Read source-aware reviewer activation handoff",
        "parameters": [
          {
            "name": "source",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[a-z0-9_]{2,64}$"
            }
          },
          {
            "name": "format",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "html",
                "md",
                "sh"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Reviewer activation payload, browser runner, markdown, or shell runner for real MCP client proof",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/r/order/{source}": {
      "get": {
        "operationId": "getPackriftSourceAwareOrderHandoff",
        "summary": "Read source-aware buyer/reviewer order handoff",
        "parameters": [
          {
            "name": "source",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[a-z0-9_]{2,64}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Buyer-approved checkout handoff preserving MCP attribution",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    }
  }
}