io.usefulapi由 usefulapi.io 發布官方發布者v1.19.5更新於 Nov 8, 2026
Search Brightpearl orders, products, stock, contacts and payments; add notes, update order status.
發布方自己的服務：Ably MCP by usefulapi
託管的 Brightpearl 連接器，讓助理搜尋訂單、商品、庫存、聯絡人與付款，新增備註並變更訂單狀態。
Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。
把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。
閱讀 https://sourceweft.com/mcp/io.usefulapi%2Fbrightpearl/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。把它新增到你客戶端的 mcpServers 設定中。
{
"mcpServers": {
"brightpearl-by-usefulapi": {
"type": "http",
"url": "https://brightpearl.usefulapi.io/mcp"
}
}
}Use Brightpearl from Claude, Cursor, or any MCP client — search sales and purchase orders, products, prices, stock availability per warehouse, goods-in and goods-out notes, contacts and customer payments, add notes to orders and contacts, and update an order's status (each write needs an explicit confirmation). Hosted, no local install: connect with the reference and token of a private app in your own Brightpearl account.
Live endpoint: https://brightpearl.usefulapi.io/mcp · Homepage: https://usefulapi.io/brightpearl
https://brightpearl.usefulapi.io/mcp.claude mcp add --transport http brightpearl https://brightpearl.usefulapi.io/mcp, then run /mcp to log in.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 Brightpearl credentials.
Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/brightpearl/
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.
*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 brightpearl_upgrade (it returns a Stripe Checkout link). Cancel any time with brightpearl_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running brightpearl_upgrade before then undoes the cancel. Or write to [email protected].
MIT © usefulapi. Not affiliated with or endorsed by Brightpearl.
來源：servers/brightpearl/README.md，提交 4046075
Get account configuration
The Brightpearl account's configuration as key/value pairs: base currency, tax scheme, time zone, default and new-order status ids, nominal codes, weight unit, whether multiple warehouses are enabled. GET /integration-service/account-configuration.
無需輸入參數。
Search orders
Search sales orders, sales credits, purchase orders and purchase credits. Every filter is optional and they combine (AND); each result row has orderId, orderTypeId, contactId, orderStatusId, orderStockStatusId, createdOn, updatedOn, customerRef, externalRef, warehouseId and more. Use brightpearl_get_orders for the full order. Order type ids: brightpearl_list_order_types; status ids: brightpearl_list_order_statuses. GET /order-service/order-search.
is_closedorder_idspage_sizeplaced_tocontact_idcreated_toupdated_toplaced_fromcreated_fromcustomer_refexternal_reffirst_result另有 8 個Get orders
Full details of one or more orders by id: type, status, payment/stock/shipping status, dates, currency, totals, assignment, customer/supplier, billing and delivery parties, and the order rows (product, quantity, price, tax). Up to 50 ids. GET /order-service/order/{ids}.
order_ids必填include_custom_fieldsGet order notes
All notes on one order (text, author contact id, date, whether it is public on the customer portal, the order status at the time). GET /order-service/order/{id}/note.
order_id必填List order statuses
The account's order statuses (id, name, order type code SO/PO/SC/PC, sort order, disabled, visible to the customer, state such as draft). Use the ids to filter orders or to change an order's status. GET /order-service/order-status.
無需輸入參數。
List order types
The four order types with their ids and codes (1 SO sales order, 2 PO purchase order, 3 SC sales credit, 4 PC purchase credit), for the order search. GET /order-service/order-type.
無需輸入參數。
Add order note
WRITE: add a note to an existing order. The note is private (staff only) unless is_public is true, which makes it visible on the customer portal. Returns the new note id. Notes cannot be removed with this server. POST /order-service/order/{id}/note.
text必填order_id必填is_publicUpdate order status
WRITE: move an existing order to another status (ids from brightpearl_list_order_statuses; the new status must exist, be visible and belong to this order's type). Brightpearl adds an order note on success, and status changes can trigger the account's alerts and automations. Moving a sales order to the account's 'cancelled' status removes its reservations and coupons and is refused while goods-out notes or payments exist. PUT /order-service/order/{id}/status.
noteorder_id必填note_is_publicorder_status_id必填Search products
Search the product catalogue. Every filter is optional and they combine (AND); each result row has productId, productName, SKU, barcode, EAN, UPC, ISBN, MPN, stockTracked, createdOn, updatedOn, brightpearlCategoryCode, productGroupId, brandId, productTypeId, productStatus, primarySupplierId. Use brightpearl_get_products for full details. GET /product-service/product-search.
eanmpnskuupcisbnnamebarcodebrand_idpage_sizecreated_toupdated_tocategory_id另有 10 個Get products
Full details of one or more products by id: identity (SKU, barcodes), brand, type, stock-tracking, weight and dimensions, tax code, sales-channel names/descriptions/categories, bundle composition, variations, per-warehouse reorder levels, supplier and status. Up to 50 ids. GET /product-service/product/{ids}.
product_ids必填include_custom_fieldsGet product prices
Prices of products per price list: for each product and price list the currency, SKU and the quantity-break price map (e.g. {"1":"12","100":"11"}). Up to 50 product ids; optionally only some price lists (ids from brightpearl_list_price_lists). GET /product-service/product-price/{product ids}/price-list/{price list ids}.
product_ids必填price_list_idsGet product stock availability
Stock availability of stock-tracked products: for each product the totals across all warehouses (inStock, onHand, allocated, inTransit) and the same per warehouse; optionally per location, with on-order quantities. Up to 50 product ids. GET /warehouse-service/product-availability/{ids}.
on_orderby_locationproduct_ids必填List price lists
The price lists (id, name, code, currency, SELL or BUY, gross or net). Id 0 is the cost price list. GET /product-service/price-list.
無需輸入參數。
Search brands
Search product brands by name; each row has brandId, brandName, createdOn, updatedOn. GET /product-service/brand-search.
namepage_sizefirst_resultSearch product categories
Search Brightpearl product categories; each row has id, name, parentId, active, createdOn, updatedOn. GET /product-service/brightpearl-category-search.
nameactivepage_sizeparent_idfirst_resultList warehouses
The warehouses (id, name, type, address id, click-and-collect settings, weekly operating hours). Use the ids for stock and order filters. GET /warehouse-service/warehouse.
無需輸入參數。
List shipping methods
The shipping methods (id, name, code, carrier, price breaks, countries). GET /warehouse-service/shipping-method.
無需輸入參數。
Search goods-out notes (shipments)
Search goods-out notes, the pick/pack/ship records of sales orders; each row has goodsOutNoteId, printed, picked, packed, shipped, shippedOn, orderId, shippingMethodId, warehouseId, createdOn, releaseDate, transfer. GET /warehouse-service/goods-note/goods-out-search.
packedpickedshippedorder_idpage_sizecreated_toshipped_tocreated_fromfirst_resultnewest_firstshipped_fromwarehouse_id另有 1 個Search goods-in notes (stock received)
Search goods-in records (stock received against purchase orders, by batch and location); each row has purchaseOrderId, batchId, productId, locationId, price, currCode, receivedQuantity, onHand, createdDate, receivedDate, warehouseId. GET /warehouse-service/goods-in-search.
batch_idpage_sizeproduct_idreceived_tofirst_resultnewest_firstwarehouse_idreceived_frompurchase_order_idSearch contacts
Search contacts (customers, suppliers and staff). Every filter is optional and they combine (AND); each result row has contactId, primaryEmail, firstName, lastName, companyName, isSupplier, isStaff, isCustomer, createdOn, updatedOn, lastOrderedOn and more. Use brightpearl_get_contacts for the full record. GET /contact-service/contact-search.
emailphonetag_idsis_stafflast_namepage_sizecreated_tofirst_nameupdated_tocompany_idscontact_idsis_customer另有 9 個Get contacts
Full records of one or more contacts by id: name, emails, phones, status, supplier/staff flags, financial details (price list, tax code, credit limit and terms), assignment, organisation, tags, dates; optionally custom fields and the full postal addresses. Up to 50 ids. GET /contact-service/contact/{ids}.
contact_ids必填include_addressesinclude_custom_fieldsAdd contact note
WRITE: add a note to a contact's timeline (for example a record of correspondence). The note is private (staff only) unless is_public is true, which makes it visible on the customer portal. Returns the new note id. Notes cannot be removed with this server. POST /contact-service/contact/{id}/note.
text必填is_publiccontact_id必填Search customer payments
Search payments received against sales orders; each row has paymentId, transactionRef, paymentMethodCode, paymentType, orderId, currencyCode, amountAuthorized, amountPaid, paymentDate, createdOn, journalId. GET /accounting-service/customer-payment-search.
order_idspage_sizecreated_topayment_topayment_idscreated_fromfirst_resultnewest_firstpayment_frompayment_typetransaction_refpayment_method_codeList payment methods
The payment methods (name, code, active, bank accounts with currency and nominal code). GET /accounting-service/payment-method.
無需輸入參數。
List tax codes
The tax codes (id, code, description, rate). GET /accounting-service/tax-code.
無需輸入參數。
已滿足適用檢查項的 100%
該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。
io.usefulapi官方發布者
面向 Ably 即時訊息的託管 MCP 伺服器：檢視頻道歷史、線上狀態與佔用情形，發布訊息，並查看應用程式用量與設定。
io.usefulapi官方發布者
託管式唯讀 MCP 伺服器，讓助理查詢 Woffu 公司的使用者、勞動契約、部門與辦公地點。
io.usefulapi官方發布者
託管的 White Label Loyalty MCP 伺服器：瀏覽獎勵、查看客戶點數錢包與等級進度，並以點數購買獎勵。
io.usefulapi官方發布者
託管的 Weekdone 連接器，讓助理讀取週報、團隊、目標與 KPI，並新增報告項目、留言和 KPI 數值。
io.usefulapi官方發布者
託管式唯讀 MCP 伺服器，讓助理列出 WebinarKit 的網路研討會、場次時間、系列、會議以及白標子帳戶。
{ "mcpServers": { "brightpearl": { "url": "https://brightpearl.usefulapi.io/mcp" } }}