{
  "info": {
    "name": "Order Desk — mcp.ai",
    "description": "REST API for the Order Desk MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/order_desk",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "order_desk_add_order_history_note",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/add/order/history/note",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "add",
            "order",
            "history",
            "note"
          ]
        },
        "description": "Append a timestamped note permanently to an existing order's history. Order history is append-only, so this tool cannot edit or remove the entry.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"note\": \"\",\n  \"order_id\": 0,\n  \"source_name\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "order_desk_add_order_item",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/add/order/item",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "add",
            "order",
            "item"
          ]
        },
        "description": "Add one line item to an existing order.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"code\": \"\",\n  \"name\": \"\",\n  \"price\": 0,\n  \"weight\": 0,\n  \"metadata\": {},\n  \"order_id\": 0,\n  \"quantity\": 0,\n  \"category_code\": \"\",\n  \"delivery_type\": \"\",\n  \"variation_list\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "order_desk_add_order_items",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/add/order/items",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "add",
            "order",
            "items"
          ]
        },
        "description": "Add two to 10 line items sequentially to the same order and return a result for every processed item. This batch is not atomic.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"items\": \"\",\n  \"order_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "order_desk_create_inventory_item",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/inventory/item",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "inventory",
            "item"
          ]
        },
        "description": "Create one inventory item with a unique SKU and return its positive Order Desk ID and complete created representation.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"code\": \"\",\n  \"cost\": 0,\n  \"name\": \"\",\n  \"price\": 0,\n  \"stock\": 0,\n  \"weight\": 0,\n  \"location\": \"\",\n  \"metadata\": {},\n  \"update_source\": \"\",\n  \"variation_list\": {},\n  \"manufacturer_sku\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "order_desk_create_inventory_items",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/inventory/items",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "inventory",
            "items"
          ]
        },
        "description": "Create two to 10 inventory items sequentially and return each created ID or error. This batch is not atomic.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"items\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "order_desk_create_shipments",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/shipments",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "shipments"
          ]
        },
        "description": "Create one or more shipment records across orders in one request and report the success or error returned for every shipment.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"shipments\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "order_desk_delete_inventory_item",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/inventory/item",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "inventory",
            "item"
          ]
        },
        "description": "Permanently delete one inventory item by its positive Order Desk ID. This destructive action cannot be undone; verify the ID before calling it.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"inventory_item_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "order_desk_delete_order_item",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/order/item",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "order",
            "item"
          ]
        },
        "description": "Permanently remove one line item from an order. This destructive action cannot be undone by this tool; verify both IDs before calling it.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"order_id\": 0,\n  \"order_item_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "order_desk_delete_shipment",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/shipment",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "shipment"
          ]
        },
        "description": "Permanently remove one shipment record from an order. This destructive action cannot be undone by this tool; verify both IDs before calling it.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"order_id\": 0,\n  \"shipment_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "order_desk_get_inventory_item",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/inventory/item",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "inventory",
            "item"
          ]
        },
        "description": "Get one inventory item by its positive Order Desk ID.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"inventory_item_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "order_desk_get_order",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/order",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "order"
          ]
        },
        "description": "Get one order and its addresses, line items, shipments, metadata, notes, and discounts by Order Desk internal ID.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"order_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "order_desk_get_store_metadata",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/store/metadata",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "store",
            "metadata"
          ]
        },
        "description": "Return safe store identity, locale, timezone, page-size settings, and folder IDs and names without exposing credentials or email configuration.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "order_desk_list_inventory_items",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/inventory/items",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "inventory",
            "items"
          ]
        },
        "description": "Search inventory items in the connected store by ID, SKU, name, metadata, manufacturer SKU, location, or update time.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"code\": \"\",\n  \"name\": \"\",\n  \"search\": \"\",\n  \"location\": \"\",\n  \"metadata\": \"\",\n  \"manufacturer_sku\": \"\",\n  \"inventory_item_id\": 0,\n  \"updated_start_date\": \"\",\n  \"exclude_update_source\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "order_desk_list_order_items",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/order/items",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "order",
            "items"
          ]
        },
        "description": "Return all line items for one order.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"order_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "order_desk_list_order_shipments",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/order/shipments",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "order",
            "shipments"
          ]
        },
        "description": "Return all shipments recorded for one order.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"order_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "order_desk_list_orders",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/orders",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "orders"
          ]
        },
        "description": "Find orders in the connected store using at least one narrowing filter and return one bounded page. Use next_cursor to continue the same query.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"email\": \"\",\n  \"limit\": 0,\n  \"order_by\": \"\",\n  \"folder_id\": \"\",\n  \"source_id\": \"\",\n  \"sort_order\": \"\",\n  \"customer_id\": \"\",\n  \"folder_name\": \"\",\n  \"next_cursor\": \"\",\n  \"source_name\": \"\",\n  \"search_end_date\": \"\",\n  \"customer_company\": \"\",\n  \"shipping_company\": \"\",\n  \"modified_end_date\": \"\",\n  \"search_start_date\": \"\",\n  \"customer_last_name\": \"\",\n  \"shipping_last_name\": \"\",\n  \"customer_first_name\": \"\",\n  \"modified_start_date\": \"\",\n  \"shipping_first_name\": \"\",\n  \"include_order_history\": false,\n  \"search_end_date_local\": \"\",\n  \"search_start_date_local\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "order_desk_move_orders",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/move/orders",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "move",
            "orders"
          ]
        },
        "description": "Move one or more orders to exactly one destination folder selected by positive ID or exact name, with a result for every order.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"order_ids\": \"\",\n  \"destination_folder_id\": 0,\n  \"destination_folder_name\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "order_desk_update_inventory_items",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/inventory/items",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "inventory",
            "items"
          ]
        },
        "description": "Safely update selected fields on one or more inventory items while preserving every omitted field.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"updates\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "order_desk_update_order_item",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/order/item",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "order",
            "item"
          ]
        },
        "description": "Safely update selected fields on one order line item while preserving every omitted field.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"changes\": {},\n  \"order_id\": 0,\n  \"order_item_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "order_desk_update_shipment",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/shipment",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "shipment"
          ]
        },
        "description": "Safely update selected fields on one shipment while preserving every omitted field.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"changes\": {},\n  \"order_id\": 0,\n  \"shipment_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}