PackGenie - Automated Shipping Solution

PackGenie API Search

Search the public PackGenie API by intent and resource. Use when: you need an operationId or matchedExpand for a resource (order, shipping address, line items). Do NOT use when: the job is get_order or search_orders. Next step: packgenie_api_read or packgenie_api_write. Do not invent GraphQL.

PackGenie API Details

Return arguments, slim defaultSelection, and the expand menu for one catalog operation. Use when: you need nested groups (shipping address, carrier, line items) and search did not return matchedExpand. Do NOT use when: get_order / search_orders already has the expand names you need.

PackGenie API Read

Execute a public PackGenie query by operationId. Use when: packgenie_api_search returned a query and the job is not get_order / search_orders. Do NOT use when: the operation is a mutation (use packgenie_api_write). Pass expand group names from search or details. Paginated lists default to first: 20. Product id/sku values are retried if the first lookup is null.

PackGenie API Write

Execute a public PackGenie mutation by operationId. Use when: packgenie_api_search returned a mutation and writes are enabled. Do NOT use when: the operation is a query (use packgenie_api_read). Requires PACKGENIE_ALLOW_MUTATIONS=true.

Get Order

Fetch one order by orderNumber or id. Default includes 10 line items, customer, and shipping address. Use when: the user gave an order number or id. Do NOT use when: you need to search many orders (use search_orders). A 10-digit value (e.g. 6829938359) is tried as id first, then orderNumber. Hyphenated values are tried as orderNumber first. Optional expand adds parcels or a fuller lineItems page (first: 10).

Create App

Create a PackGenie App and its initial draft version. Use when: the user wants to start a new app. Next: packgenie init --app-id <id>. src/app/orders is a reference page; single-page apps belong on Home (src/app/page.tsx) — delete src/app/orders since extra pages nest under Home in the nav. Then packgenie deploy, then publish_app. Do NOT use when: the user only wants order data in this chat (use search_orders). Requires PACKGENIE_ALLOW_MUTATIONS=true.

List Apps

List PackGenie Apps and their draft and published versions. Use when: the user wants to inspect available Apps.

Publish App

Publish the current draft version of a PackGenie App. Use when: packgenie deploy has uploaded the draft and it is ready to make live. Do NOT use when: the app source has not been written and deployed yet. Requires PACKGENIE_ALLOW_MUTATIONS=true.

Uninstall App

Uninstall a PackGenie App. Use when: the user wants to remove an installed App. Requires PACKGENIE_ALLOW_MUTATIONS=true.

Search Orders

List or search orders. Omit query to get the latest orders (ORDER_PLACED DESC). Use when: the user wants recent orders, a text search, or a status filter. Do NOT use when: you already have an order number or id (use get_order), or the user wants a merchant admin app (create_app, then the CLI scaffold src/app/orders). query is optional. Do not pass *. Filter with statuses (AWAITING_FULFILLMENT, SHIPPED) or inventoryStatuses (BACK_ORDERED, ALLOCATED). first defaults to 20 (max 250). Optional expa

Execute GraphQL

Run a raw GraphQL query or mutation against PackGenie. Use when: catalog expand groups cannot express the selection. Do NOT use when: a catalog tool or expand group exists. Requires Api-Key or Bearer (HTTP). Mutations require PACKGENIE_ALLOW_MUTATIONS=true. Disabled unless PACKGENIE_ALLOW_EXECUTE_GRAPHQL=true.