Freshly Inventory MCP by usefulapi

io.usefulapi由 usefulapi.io 發布官方發布者v1.2.3更新於 Nov 5, 2026

Read batches and assignments; create, update and assign batches in Freshly Inventory.

發布方自己的服務:Ably MCP by usefulapi

已驗證Streamable HTTP可網頁執行資料庫商業與電商

概覽

AI 產生的概覽

託管式 Freshly Inventory MCP 伺服器,讓助理讀取、建立、更新並分配 Shopify 庫存批次(批次追蹤)。

可以做什麼
  • 查詢已連接的 Shopify 商店並確認金鑰可用
  • 列出並讀取庫存批次,可依地點、變體、名稱、編號、條碼或發票篩選
  • 列出某個 Shopify 訂單明細項目已分配的批次
  • 為某地點的某變體建立新批次,可選擇同時同步 Shopify 庫存數量
  • 更新批次欄位,例如數量、地點、變體、日期或文字
  • 將某批次的數量分配到訂單明細項目,或移除既有分配
適用情境
適合在 Freshly 中依批次追蹤庫存,並希望助理回答效期、數量以及某張訂單出的是哪一批,或在不開啟後台的情況下登記新批次與分配的情境。
執行需求
僅需遠端端點,無須本機安裝;以伺服器 URL 連線並透過 OAuth 登入。首次連線時需提供 Freshly API 金鑰(在 Freshly 的 Preferences → API keys 取得),伺服器會驗證並依使用者儲存。用戶端設定中不要填入 API 金鑰或 Authorization 標頭。
安裝前請注意
有四個工具會建立、修改或刪除 Freshly 資料,建立與更新在開啟同步時還會變更 Shopify 庫存數量,執行前應先確認。伺服器會依使用者儲存你的 Freshly API 金鑰。呼叫次數有限制:免費方案每月 50 次,升級工具會回傳付費方案的 Stripe 結帳連結。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Freshly Inventory MCP by usefulapi,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.usefulapi%2Ffreshly-inventory/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "freshly-inventory-by-usefulapi": {
      "type": "http",
      "url": "https://freshly-inventory.usefulapi.io/mcp"
    }
  }
}

README

Freshly Inventory MCP by usefulapi

Use your Freshly account from Claude, Cursor, or any MCP client. Reads and manages inventory batches and their order-line assignments, and changes Shopify stock only when you turn sync on. Hosted, no local install: connect with your own credentials.

Live endpoint: https://freshly-inventory.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://freshly-inventory.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http freshly-inventory https://freshly-inventory.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "freshly-inventory": {      "url": "https://freshly-inventory.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Freshly Inventory credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/freshly-inventory/

On first connect you provide your Freshly API key (Preferences → API keys in Freshly; Freshly shows it once). The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
freshly_get_shopreadGet Freshly shop
freshly_list_inventory_batchesreadList inventory batches
freshly_get_inventory_batchreadGet inventory batch
freshly_list_batch_assignmentsreadList batch assignments for an order line
freshly_create_inventory_batchwriteCreate inventory batch
freshly_update_inventory_batchwriteUpdate inventory batch
freshly_assign_batch_to_line_itemwriteAssign batch to order line
freshly_remove_batch_assignmentwriteRemove batch assignment from order line
freshly_usage_statusmetaUsage status (free-tier meter)
freshly_request_featuremetaRequest a missing feature
freshly_upgrademetaUpgrade to Pro or Pro+
freshly_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with freshly_upgrade (it returns a Stripe Checkout link). Cancel any time with freshly_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running freshly_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

來源:servers/freshly-inventory/README.md,提交 4046075

工具

8

freshly_get_shop

Get Freshly shop

Return the Shopify store this API key belongs to (store name and shopify_domain). Good first call to confirm the key works. Freshly API: GET /api/shopify/shop.

無需輸入參數。

freshly_list_inventory_batches

List inventory batches

List inventory batches (lot tracking) with quantity, received and expiry dates and metadata. Filter by Shopify location or variant, or search by batch name, number, barcode or invoice. Freshly API: GET /api/shopify/inventory_batches.

輸入參數pagesearchvariant_idlocation_id

freshly_get_inventory_batch

Get inventory batch

Return one inventory batch by its Freshly id. Freshly API: GET /api/shopify/inventory_batches/:id.

輸入參數batch_id必填

freshly_list_batch_assignments

List batch assignments for an order line

List the inventory batches assigned to one Shopify order line item (batch, quantity, assignment id). Freshly API: GET /api/shopify/inventory_batch_order_items.

輸入參數order_id必填line_item_id必填

freshly_create_inventory_batch

Create inventory batch

Create a new inventory batch of one product variant at one Shopify location. Set enable_shopify_sync true only when the Shopify stock level must change too. Freshly API: POST /api/shopify/inventory_batches.

輸入參數barcodequantity必填batch_namevariant_id必填descriptionexpiry_datelocation_id必填batch_numberreceived_dateinvoice_numberenable_shopify_sync

freshly_update_inventory_batch

Update inventory batch

Change fields of one inventory batch (quantity, location, variant, dates or text). Only the fields you pass change. Set enable_shopify_sync true only when the Shopify stock level must change too. Freshly API: PUT /api/shopify/inventory_batches/:id.

輸入參數barcodebatch_id必填quantitybatch_namevariant_iddescriptionexpiry_datelocation_idbatch_numberreceived_dateinvoice_numberenable_shopify_sync

freshly_assign_batch_to_line_item

Assign batch to order line

Assign a quantity of one inventory batch to one Shopify order line item, so Freshly tracks which lot shipped. Freshly API: POST /api/shopify/inventory_batch_order_items.

輸入參數order_id必填quantity必填line_item_id必填inventory_batch_id必填

freshly_remove_batch_assignment

Remove batch assignment from order line

Remove one batch assignment from an order line item (the assignment id comes from freshly_list_batch_assignments). Freshly API: DELETE /api/shopify/inventory_batch_order_items/:id.

輸入參數assignment_id必填

版本歷史

6
  1. v1.2.3最新Nov 5, 2026
  2. v1.2.2Nov 5, 2026
  3. v1.2.1Nov 4, 2026
  4. v1.2.0Nov 3, 2026
  5. v1.1.1Nov 3, 2026
  6. v1.0.0Nov 1, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Usefulapi 整合