Kuaidi100 launched China's first MCP-protocol-compatible logistics information service platform. The core API services of Kuaidi100's Baidiy
Brightpearl MCP by usefulapi is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
What it does
Search Brightpearl orders, products, stock, contacts and payments; add notes, update order status.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user --transport http brightpearl-mcp-by-usefulapi https://brightpearl.usefulapi.io/mcp
# 2 — ask your agent for something these tools do
# brightpearl_get_account_configuration, brightpearl_search_orders, brightpearl_get_orders and 22 more
Brightpearl MCP by usefulapi costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. Nothing here runs on your machine and nothing runs on ours: this server answers at its publisher’s own address, and what you install is the connection straight to it.
This is a public server: it answers at its publisher’s own address and this marketplace is not in the path. Claude Code registers it in one command; --scope user makes it available in every project. The transport below is http, as the publisher's own manifest declares it.
claude mcp add --scope user --transport http brightpearl-mcp-by-usefulapi https://brightpearl.usefulapi.io/mcpReconnect, or start a new session, and the tools appear in the model’s tool list.
One config entry pointing straight at the publisher’s own address — this marketplace is not in the path, and nothing from this listing executes on your machine.
25 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
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.
No parameter schema on file.
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_li
| Parameter | Type | Required | Notes |
|---|---|---|---|
| order_ids | array | no | Only these orders (one or more ids). |
| order_type_id | integer | no | Order type id (1 sales order, 2 purchase order, 3 sales credit, 4 purchase credit; see brightpearl_list_order_types). |
| order_status_id | integer | no | Order status id (brightpearl_list_order_statuses). |
| contact_id | integer | no | Only orders of this customer/supplier contact id. |
| customer_ref | string | no | Customer reference of the order. |
| external_ref | string | no | External reference of the order (for example the web shop's order number). |
| id_or_external_ref | string | no | Matches an order id OR an external reference (case-insensitive match). |
| warehouse_id | array | no | Only orders for these warehouses (one or more ids). |
| payment_status_id | integer | no | Order payment status id. |
| shipping_status_id | integer | no | Order shipping status id. |
| is_closed | boolean | no | Whether the order is invoiced (closed). |
| created_from | string | no | Created: on or after this day (yyyy-mm-dd) or ISO 8601 date-time with timezone. |
| created_to | string | no | Created: on or before this day (yyyy-mm-dd, whole day included) or ISO 8601 date-time with timezone. |
| updated_from | string | no | Last updated: on or after this day (yyyy-mm-dd) or ISO 8601 date-time with timezone. |
| updated_to | string | no | Last updated: on or before this day (yyyy-mm-dd, whole day included) or ISO 8601 date-time with timezone. |
| placed_from | string | no | Placed: on or after this day (yyyy-mm-dd) or ISO 8601 date-time with timezone. |
| placed_to | string | no | Placed: on or before this day (yyyy-mm-dd, whole day included) or ISO 8601 date-time with timezone. |
| page_size | integer | no | Rows per page, 1-500 (default 25). |
| first_result | integer | no | Position of the first row to return, from 1 (default 1). Pass the previous reply's next_first_result for the next page. |
| newest_first | boolean | no | Newest (highest id) first. Default: oldest first. |
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}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| order_ids | array | yes | Order ids (1-50 ids). |
| include_custom_fields | boolean | no | Also return the order's custom field values (includeOptional=customFields,nullCustomFields). |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| order_id | integer | yes | Order id. |
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.
No parameter schema on file.
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.
No parameter schema on file.
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| order_id | integer | yes | Order id. |
| text | string | yes | The note text. |
| is_public | boolean | no | Visible to the customer on the customer portal. Default false. |
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
| Parameter | Type | Required | Notes |
|---|---|---|---|
| order_id | integer | yes | Order id. |
| order_status_id | integer | yes | The new order status id. |
| note | string | no | Text of the order note Brightpearl adds (default: generated by Brightpearl). |
| note_is_public | boolean | no | Make that note visible on the customer portal. Default false. |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| product_ids | array | no | Only these products (one or more ids). |
| name | string | no | Product name (case-insensitive match). |
| sku | string | no | Exact SKU. |
| barcode | string | no | Barcode. |
| ean | string | no | EAN. |
| upc | string | no | UPC. |
| isbn | string | no | ISBN. |
| mpn | string | no | MPN. |
| stock_tracked | boolean | no | Only stock-tracked (true) or non-stock (false) products. |
| brand_id | array | no | Only these brands (one or more ids). |
| product_type_id | array | no | Only these product types (one or more ids). |
| category_id | array | no | Only these Brightpearl categories (one or more ids). |
| product_group_id | integer | no | Only products of this product group (variations); 0 = products that are not in a group. |
| product_status | string | no | Lifecycle status code, for example LIVE. |
| primary_supplier_id | array | no | Only products with these primary suppliers (one or more ids). |
| created_from | string | no | Created: on or after this day (yyyy-mm-dd) or ISO 8601 date-time with timezone. |
| created_to | string | no | Created: on or before this day (yyyy-mm-dd, whole day included) or ISO 8601 date-time with timezone. |
| updated_from | string | no | Last updated: on or after this day (yyyy-mm-dd) or ISO 8601 date-time with timezone. |
| updated_to | string | no | Last updated: on or before this day (yyyy-mm-dd, whole day included) or ISO 8601 date-time with timezone. |
| page_size | integer | no | Rows per page, 1-500 (default 25). |
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}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| product_ids | array | yes | Product ids (1-50 ids). |
| include_custom_fields | boolean | no | Also return custom field values (includeOptional=customFields,nullCustomFields). |
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}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| product_ids | array | yes | Product ids (1-50 ids). |
| price_list_ids | array | no | Only these price list ids (0 is the cost price list). |
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}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| product_ids | array | yes | Product ids (1-50 ids). |
| by_location | boolean | no | Also break the figures down by location within each warehouse. |
| on_order | boolean | no | Also include quantities on open purchase orders (total and shipped). |
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.
No parameter schema on file.
Search product brands by name; each row has brandId, brandName, createdOn, updatedOn. GET /product-service/brand-search.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | no | Brand name (case-insensitive match). |
| page_size | integer | no | Rows per page, 1-500 (default 25). |
| first_result | integer | no | Position of the first row to return, from 1 (default 1). Pass the previous reply's next_first_result for the next page. |
Search Brightpearl product categories; each row has id, name, parentId, active, createdOn, updatedOn. GET /product-service/brightpearl-category-search.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | no | Category name. |
| parent_id | integer | no | Only the children of this category; 0 = the top-level categories. |
| active | boolean | no | Only active (true) or inactive (false) categories. |
| page_size | integer | no | Rows per page, 1-500 (default 25). |
| first_result | integer | no | Position of the first row to return, from 1 (default 1). Pass the previous reply's next_first_result for the next page. |
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.
No parameter schema on file.
The shipping methods (id, name, code, carrier, price breaks, countries). GET /warehouse-service/shipping-method.
No parameter schema on file.
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| order_id | integer | no | Only notes of this order. |
| warehouse_id | integer | no | Only notes of this warehouse. |
| shipped | boolean | no | Only shipped (true) or not yet shipped (false) notes. |
| picked | boolean | no | Only picked (true) or not yet picked (false) notes. |
| packed | boolean | no | Only packed (true) or not yet packed (false) notes. |
| shipping_method_id | array | no | Only these shipping methods (one or more ids). |
| shipped_from | string | no | Shipped: on or after this day (yyyy-mm-dd) or ISO 8601 date-time with timezone. |
| shipped_to | string | no | Shipped: on or before this day (yyyy-mm-dd, whole day included) or ISO 8601 date-time with timezone. |
| created_from | string | no | Created: on or after this day (yyyy-mm-dd) or ISO 8601 date-time with timezone. |
| created_to | string | no | Created: on or before this day (yyyy-mm-dd, whole day included) or ISO 8601 date-time with timezone. |
| page_size | integer | no | Rows per page, 1-500 (default 25). |
| first_result | integer | no | Position of the first row to return, from 1 (default 1). Pass the previous reply's next_first_result for the next page. |
| newest_first | boolean | no | Newest (highest id) first. Default: oldest first. |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| purchase_order_id | integer | no | Only stock received on this purchase order. |
| product_id | integer | no | Only this product. |
| warehouse_id | integer | no | Only this warehouse. |
| batch_id | integer | no | Only this batch. |
| received_from | string | no | Received: on or after this day (yyyy-mm-dd) or ISO 8601 date-time with timezone. |
| received_to | string | no | Received: on or before this day (yyyy-mm-dd, whole day included) or ISO 8601 date-time with timezone. |
| page_size | integer | no | Rows per page, 1-500 (default 25). |
| first_result | integer | no | Position of the first row to return, from 1 (default 1). Pass the previous reply's next_first_result for the next page. |
| newest_first | boolean | no | Newest batch (highest batch id) first. Default: oldest first. |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| contact_ids | array | no | Only these contacts (one or more ids). |
| string | no | Matches any of the contact's email addresses (case-insensitive match). | |
| exact_primary_email | string | no | Exact primary email address. |
| first_name | string | no | First name (case-insensitive match). |
| last_name | string | no | Last name (case-insensitive match). |
| company_name | string | no | Company name (case-insensitive match). |
| phone | string | no | Matches any of the telephone or mobile numbers. |
| is_customer | boolean | no | Only customers (true). |
| is_supplier | boolean | no | Only suppliers (true). |
| is_staff | boolean | no | Only staff (true). |
| tag_ids | array | no | Only contacts with these tag ids (one or more ids). |
| company_ids | array | no | Only contacts of these company ids (one or more ids). |
| created_from | string | no | Created: on or after this day (yyyy-mm-dd) or ISO 8601 date-time with timezone. |
| created_to | string | no | Created: on or before this day (yyyy-mm-dd, whole day included) or ISO 8601 date-time with timezone. |
| updated_from | string | no | Last updated: on or after this day (yyyy-mm-dd) or ISO 8601 date-time with timezone. |
| updated_to | string | no | Last updated: on or before this day (yyyy-mm-dd, whole day included) or ISO 8601 date-time with timezone. |
| last_ordered_from | string | no | Last ordered: on or after this day (yyyy-mm-dd) or ISO 8601 date-time with timezone. |
| last_ordered_to | string | no | Last ordered: on or before this day (yyyy-mm-dd, whole day included) or ISO 8601 date-time with timezone. |
| page_size | integer | no | Rows per page, 1-500 (default 25). |
| first_result | integer | no | Position of the first row to return, from 1 (default 1). Pass the previous reply's next_first_result for the next page. |
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}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| contact_ids | array | yes | Contact ids (1-50 ids). |
| include_custom_fields | boolean | no | Also return custom field values. |
| include_addresses | boolean | no | Also return the full postal addresses. |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| contact_id | integer | yes | Contact id. |
| text | string | yes | The note text. |
| is_public | boolean | no | Visible to the customer on the customer portal. Default false. |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| payment_ids | array | no | Only these payments (one or more ids). |
| order_ids | array | no | Only payments on these orders (one or more ids). |
| payment_method_code | string | no | Payment method code (brightpearl_list_payment_methods). |
| payment_type | string | no | Payment type, for example RECEIPT, CAPTURE, AUTH. |
| transaction_ref | string | no | The payment gateway's transaction reference. |
| payment_from | string | no | Payment date: on or after this day (yyyy-mm-dd) or ISO 8601 date-time with timezone. |
| payment_to | string | no | Payment date: on or before this day (yyyy-mm-dd, whole day included) or ISO 8601 date-time with timezone. |
| created_from | string | no | Created: on or after this day (yyyy-mm-dd) or ISO 8601 date-time with timezone. |
| created_to | string | no | Created: on or before this day (yyyy-mm-dd, whole day included) or ISO 8601 date-time with timezone. |
| page_size | integer | no | Rows per page, 1-500 (default 25). |
| first_result | integer | no | Position of the first row to return, from 1 (default 1). Pass the previous reply's next_first_result for the next page. |
| newest_first | boolean | no | Newest (highest id) first. Default: oldest first. |
The payment methods (name, code, active, bank accounts with currency and nominal code). GET /accounting-service/payment-method.
No parameter schema on file.
The tax codes (id, code, description, rate). GET /accounting-service/tax-code.
No parameter schema on file.
- Every tool — any call limit is its publisher’s, not ours
- No card, and mcprush charges nothing for it
- Runs at its publisher’s own address — this marketplace is not in the path
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install Brightpearl MCP by usefulapi or to call it, at any volume.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
| Term | Level | What it prices | Points |
|---|---|---|---|
| capability-exposure | moderate | capability blast radius (moderate) — client exposure if the model is manipulated | −3 |
| coverage-honesty | manifest | inspection depth (manifest) — how much of the target the scan could see | −4 |
What the scan could actually read
A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.
The scan read each tool’s name, description, input schema and annotations exactly as the server listed them the last time it answered us; no code was reviewed. We ask the server again about once a month, and a list that changed is graded again.
The implementation source was not read — this reflects the declared tool metadata only.
Capability — what it could do if the model were manipulated
Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. moderate is the level these add up to.
| Tool | Capability tags | Why the tag was assigned |
|---|---|---|
| brightpearl_get_account_configuration | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| brightpearl_search_orders | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| brightpearl_get_orders | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| brightpearl_get_order_notes | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| brightpearl_list_order_statuses | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| brightpearl_list_order_types | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| brightpearl_add_order_note | external-sink | external-sink: declares readOnlyHint: false, destructiveHint: true, openWorldHint: true |
| brightpearl_update_order_status | external-sink | external-sink: declares readOnlyHint: false, destructiveHint: true, openWorldHint: true |
| brightpearl_search_products | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| brightpearl_get_products | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| brightpearl_get_product_prices | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| brightpearl_get_product_availability | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| brightpearl_list_price_lists | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| brightpearl_search_brands | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| brightpearl_search_categories | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| brightpearl_list_warehouses | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| brightpearl_list_shipping_methods | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| brightpearl_search_goods_out_notes | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| brightpearl_search_goods_in_notes | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| brightpearl_search_contacts | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| brightpearl_get_contacts | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| brightpearl_add_contact_note | external-sink | external-sink: declares readOnlyHint: false, destructiveHint: true, openWorldHint: true |
| brightpearl_search_customer_payments | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| brightpearl_list_payment_methods | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| brightpearl_list_tax_codes | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
Toxic-flow graph
The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.
Supply chain and provenance
This is the first scan of this surface here, so there is nothing yet to compare it against.
Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.
Release history
This is an address its publisher runs: which release it serves is theirs to choose, so there is nothing here to pin. The history below is for reading; the current release on file is 1.19.2.
No release note was published with this version.
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Any signed-in account that does not publish Brightpearl MCP by usefulapi can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.