BoxHero MCP by usefulapi
io.usefulapi/boxhero · v1.1.0 · MCP 2025-11-25
Read stock and orders, create or update items, and record stock moves in BoxHero.
Reachability
reachable
checked 2026-11-21 05:31 UTC
Registry status active
Tools pinned 23
e18d759c1f42
Tools last changed
unchanged since first capture 2026-11-21
Repo last push 2026-11-21
as of 2026-11-21
GitHub stars 1
as of 2026-11-21
Provenance
Registry namespace io.usefulapi
(domain verified by the official registry)
Repository
github.com/m190/usefulapi-mcp
Website
https://usefulapi.io/boxhero/
Remote endpoints
https://boxhero.usefulapi.io/mcp (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-11-21 05:31 | first capture | 23 tools pinned |
Pinned tool definitions (23)
| Tool | Description |
|---|---|
| boxhero_get_team | The BoxHero team this API token belongs to: id, name, currency (code, symbol, price decimals), memo and mode. The API needs the team in LOCATION mode (mode 2) for items, locations, transactions and orders. GET /teams/linked. |
| boxhero_list_members | List the active team members (id, name, role admin/member/viewer). Use the ids to filter orders by creator. GET /members. |
| boxhero_list_items | List inventory items with SKU, barcode, cost, price, custom attributes, total quantity and the per-location stock breakdown. Pass location_ids to limit the quantities (and the list) to items with stock at those locations; item_ids to... |
| boxhero_get_item | One item by id, with its attributes, total quantity and stock per location. GET /items/{item_id}. |
| boxhero_get_item_by_sku | Look up one item by its SKU (case-insensitive) and return the same payload as boxhero_get_item. GET /items/by-sku/{sku}. |
| boxhero_list_item_attributes | List the custom attribute specs defined for items (id, attr_name, attr_type text/date/number/barcode, rank). The ids are used when creating or updating items. File-type attributes are not included. GET /item-attrs. |
| boxhero_create_item | WRITE: create a new inventory item. Optionally seed initial stock with quantity (and location_id when the team has more than one active location; with one location it is used automatically). Without quantity the item starts at zero... |
| boxhero_update_item | WRITE: change an item's name, SKU, barcode, photo, cost, price or custom attributes. Only the fields you pass change (an attribute with value null is removed; photo_url '' clears the photo). Stock levels are NOT changed here: use... |
| boxhero_list_locations | List the active storage locations (warehouses, stores...) with id, name, memo and total quantity stored. Location ids are needed for stock transactions. GET /locations. |
| boxhero_get_location | One location by id. GET /locations/{location_id}. |
| boxhero_create_location | WRITE: create a storage location. The name must be unique in the team; the plan's location limit applies (HTTP 402 when over it). POST /locations. |
| boxhero_update_location | WRITE: rename a location or change its memo (memo '' clears it). Only the fields you pass change. PUT /locations/{location_id}. |
| boxhero_list_partners | List business partners: suppliers (type 0, used on Stock In) and customers (type 1, used on Stock Out) with contact details. Cursor-paged by id. GET /partners. |
| boxhero_get_partner | One partner (supplier or customer) by id. GET /partners/{partner_id}. |
| boxhero_create_partner | WRITE: add a supplier (type 0) or customer (type 1) to BoxHero. It only stores contact details; BoxHero does not contact the partner. The plan's partner limit applies (HTTP 402). POST /partners. |
| boxhero_update_partner | WRITE: change a partner's name or contact details. The name is required by BoxHero (pass the current one to keep it); the other fields change only when passed. A partner's type cannot be changed. PUT /partners/{partner_id}. |
| boxhero_list_transactions | List stock transactions (Stock In, Stock Out, Move, Adjust), newest first, as summaries: type, locations, partner, memo, time, creator, item count, total quantity and revision. Use boxhero_get_transaction for the line items and new... |
| boxhero_get_transaction | One stock transaction by id with all its lines; pass revision for an earlier version of it. GET /transactions/{tx_id}. |
| boxhero_record_stock_transaction | WRITE: record a stock movement that CHANGES stock levels. type 'in' adds stock at to_location_id (optional supplier partner_id), 'out' removes stock at to_location_id (optional customer partner_id; stock may go negative), 'move'... |
| boxhero_list_purchase_orders | List purchase orders (stock you ordered from suppliers), newest first: order number, status, supplier, totals, estimated date. Line items and fulfillment progress come from boxhero_get_purchase_order. Cursor-paged. GET /purchase-orders. |
| boxhero_get_purchase_order | One purchase order by id with every line (item, price, quantity, tax, discount), additional costs, tags, custom fields and fulfillment progress. GET /purchase-orders/{order_id}. |
| boxhero_list_sales_orders | List sales orders (stock you sold to customers), newest first: order number, status, customer, totals, estimated date. Line items, returns and fulfillment progress come from boxhero_get_sales_order. Cursor-paged. GET /sales-orders. |
| boxhero_get_sales_order | One sales order by id with every line (item, price, quantity, returned quantity), additional costs, tags, custom fields and fulfillment progress. GET /sales-orders/{order_id}. |
Get alerted when this changes.
Email the moment io.usefulapi/boxhero drifts, dies, or revives.
Status badge
[](https://toolpin.dev/servers/io.usefulapi/boxhero)
Maintain this server? Add the badge to your README. It links your users to this live status page.