BrewMan MCP by usefulapi
Read orders, outlets, stock and purchase orders, and create or cancel orders in BrewMan.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (5)
- HIGH
- MEDIUMin brewman_get_stock_levels
- MEDIUMin brewman_get_stock_incoming_outgoing
- MEDIUMin brewman_list_purchase_orders
- LOWin brewman_get_stock_incoming_outgoing
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"brewman": {
"url": "https://brewman.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://brewman.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (14)
🟢brewman_get_current_user
Return the BrewMan user that the Api-Token belongs to, with its tenant group id. Use it to confirm the connection. BrewMan API: POST /webapi/User/v1/GetCurrentUserContext.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢brewman_list_outlets
List all outlets (customers: pubs, shops, accounts) in the tenant. Use the outlet ids with the order tools. BrewMan API: POST /webapi/Outlet/v1/GetAllOutlets.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢brewman_get_outlet(outlet_id)
Get one outlet by id, with its contact, address, price list and credit terms. BrewMan API: POST /webapi/Outlet/v1/GetOutlet.
Eingabe-Schema
{
"type": "object",
"properties": {
"outlet_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "The outlet id (from brewman_list_outlets)."
}
},
"required": [
"outlet_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢brewman_list_orders(filter)
List full orders (header and lines) that match a filter. Dates are inclusive yyyy-mm-dd. Results can be large: set filter.maximumResults. BrewMan API: POST /webapi/Order/v2/GetOrdersByFilter.
Eingabe-Schema
{
"type": "object",
"properties": {
"filter": {
"description": "Order filter. All fields are optional.",
"type": "object",
"properties": {
"maximumResults": {
"description": "Maximum number of results to return.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"limitStatuses": {
"description": "Only orders in these statuses.",
"type": "array",
"items": {
"type": "string",
"enum": [
"Open",
"Complete",
"Historic",
"Cancelled",
"Posting",
"Draft"
]
}
},
"outletIds": {
"description": "Only orders for these outlet ids.",
"type": "array",
"items": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
}
},
"orderIds": {
"description": "Only these order ids.",
"type": "array",
"items": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
}
},
"orderNumbers": {
"description": "Only these order numbers.",
"type": "array",
"items": {
"type": "string"
}
},
"sources": {
"description": "Only orders from these sources.",
"type": "array",
"items": {
"type": "string",
"enum": [
"BrewMan",
"WooCommerce",
"Shopify",
"Sellar",
"Zettle",
"Other",
"EposNow",
"Beerflex",
"Square",
"Squarespace",
"Ecwid",
"EeBria",
"Commerce7",
"TradePortal",
"Amazon",
"BigCommerce",
"GoTab"
]
}
},
"fromOrderDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"toOrderDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"fromDeliveryDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"toDeliveryDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"fromDespatchDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"toDespatchDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢brewman_get_order(order_id)
Get one order by id, with its header and lines. BrewMan API: POST /webapi/Order/v2/GetOrder.
Eingabe-Schema
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "The order id (from brewman_list_orders)."
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢brewman_list_items(filter)
List items (products, materials, services) that match a filter. Use the item ids with stock and order tools. BrewMan API: POST /webapi/Item/v1/GetItemsByFilter.
Eingabe-Schema
{
"type": "object",
"properties": {
"filter": {
"description": "Item filter. All fields are optional.",
"type": "object",
"properties": {
"maximumResults": {
"description": "Maximum number of results to return.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"mainPurposes": {
"description": "Only items with these purposes.",
"type": "array",
"items": {
"type": "string",
"enum": [
"Material",
"Product",
"DeliveryService",
"BottleDepositCharge",
"BottleDepositRedemption",
"AutoAssembledItem",
"PoDeliveryService"
]
}
},
"codes": {
"description": "Only items with these codes.",
"type": "array",
"items": {
"type": "string"
}
},
"itemIds": {
"description": "Only these item ids.",
"type": "array",
"items": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
}
},
"productBrandIds": {
"description": "Only items of these product brands.",
"type": "array",
"items": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
}
},
"stockGroupIds": {
"description": "Only items in these stock groups.",
"type": "array",
"items": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
}
}
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢brewman_get_stock_levels(stock_location_ids, stock_item_ids)
Get the current stock level (all batches summed) per stock item and stock location. Narrow it with the id lists. BrewMan API: POST /webapi/Stock/v1/GetStockItemsQuantityCurrentlyInStock.
Eingabe-Schema
{
"type": "object",
"properties": {
"stock_location_ids": {
"description": "Only these stock locations (from the stock location list).",
"type": "array",
"items": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
}
},
"stock_item_ids": {
"description": "Only these stock items (item ids).",
"type": "array",
"items": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢brewman_get_stock_incoming_outgoing(stock_location_ids, item_ids)
Get the known incoming and outgoing stock totals (on purchase orders, allocated to orders, in transfers) for items and locations. BrewMan API: POST /webapi/Stock/v1/GetStockIncomingOutgoing.
Eingabe-Schema
{
"type": "object",
"properties": {
"stock_location_ids": {
"description": "Stock location ids to report on.",
"type": "array",
"items": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
}
},
"item_ids": {
"description": "Item ids to report on.",
"type": "array",
"items": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢brewman_list_price_lists
List all price lists with their currency and whether they use gross pricing. Use the ids when you create an order. BrewMan API: POST /webapi/PriceList/v1/GetAllPriceLists.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢brewman_list_purchase_orders(filter)
List purchase orders that match a filter (status, supplier, dates). Dates are inclusive yyyy-mm-dd. BrewMan API: POST /webapi/PurchaseOrder/v1/GetPurchaseOrdersByFilter.
Eingabe-Schema
{
"type": "object",
"properties": {
"filter": {
"description": "Purchase order filter. All fields are optional.",
"type": "object",
"properties": {
"maximumResults": {
"description": "Maximum number of results to return.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"statuses": {
"description": "Only purchase orders in these statuses.",
"type": "array",
"items": {
"type": "string",
"enum": [
"Open",
"AwaitingConfirmation",
"AwaitingCompletion",
"Complete",
"Posting",
"Historic",
"Cancelled"
]
}
},
"purchaseOrderNumbers": {
"description": "Only these purchase order numbers.",
"type": "array",
"items": {
"type": "string"
}
},
"supplierIds": {
"description": "Only purchase orders with these suppliers.",
"type": "array",
"items": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
}
},
"createdFrom": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"createdTo": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"expectedDeliveryDateFrom": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"expectedDeliveryDateTo": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴brewman_create_order(outlet_id, customer_reference, delivery_date, despatch_date, duty_return_date_override, ...)
Create a new order for an outlet, in Open status. Then add lines with brewman_add_order_line. Writes to the BrewMan tenant. BrewMan API: POST /webapi/Order/v1/CreateOrder.
Eingabe-Schema
{
"type": "object",
"properties": {
"outlet_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "The outlet the order is for. Required; it cannot be changed later."
},
"customer_reference": {
"description": "Customer reference shown on documents.",
"type": "string"
},
"delivery_date": {
"description": "Delivery date (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"despatch_date": {
"description": "Despatch date (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"duty_return_date_override": {
"description": "Special duty return date, only when needed.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"standard_order_type": {
"description": "Duty and price type of the order.",
"type": "string",
"enum": [
"FullPriceDutyPaid",
"PriceExcludingDutyDutySuspended",
"FullPriceDutyPaidElsewhere",
"ExportDutySuspended",
"ConsumeOnPremisesNoDuty"
]
},
"price_list_id": {
"description": "Price list id (from brewman_list_price_lists).",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
},
"order_source": {
"description": "Source system of the order.",
"type": "string",
"enum": [
"BrewMan",
"WooCommerce",
"Shopify",
"Sellar",
"Zettle",
"Other",
"EposNow",
"Beerflex",
"Square",
"Squarespace",
"Ecwid",
"EeBria",
"Commerce7",
"TradePortal",
"Amazon",
"BigCommerce",
"GoTab"
]
},
"external_reference": {
"description": "Reference of the order in the source system. Cannot be changed later.",
"type": "string"
}
},
"required": [
"outlet_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴brewman_add_order_line(order_id, order_line_id, stock_location_id, stock_item_id, quantity, ...)
Add a stock item line to an open order. Pass a new GUID as order_line_id for each line. Writes to the BrewMan tenant. BrewMan API: POST /webapi/Order/v1/AddLineToOrder.
Eingabe-Schema
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "The order to add the line to (from brewman_create_order or brewman_list_orders)."
},
"order_line_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "A new GUID for the line. Generate one for each new line."
},
"stock_location_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "The stock location the line is taken from."
},
"stock_item_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "The stock item (item id) to add."
},
"quantity": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Quantity to add, in the unit of measure."
},
"unit_of_measure_id": {
"description": "Unit of measure id of the quantity.",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
},
"urn": {
"description": "Optional URN text of the line, sent as given.",
"type": "string"
}
},
"required": [
"order_id",
"order_line_id",
"stock_location_id",
"stock_item_id",
"quantity"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴brewman_delete_order_lines(order_header_id, line_ids)
Delete one or more lines from an order. This cannot be undone through the API. BrewMan API: POST /webapi/Order/v1/DeleteLinesFromOrder.
Eingabe-Schema
{
"type": "object",
"properties": {
"order_header_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "The order id the lines belong to."
},
"line_ids": {
"minItems": 1,
"type": "array",
"items": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
},
"description": "The ids of the lines to delete."
}
},
"required": [
"order_header_id",
"line_ids"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴brewman_cancel_order(order_id, cancellation_reason)
Cancel an order and give the reason. A cancelled order cannot be reopened through the API. BrewMan API: POST /webapi/Order/v1/CancelOrder.
Eingabe-Schema
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "The order to cancel."
},
"cancellation_reason": {
"type": "string",
"minLength": 1,
"description": "Why the order is cancelled. BrewMan records it."
}
},
"required": [
"order_id",
"cancellation_reason"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis