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

B
Qualität der Beschreibung
100%
Vollständigkeit des Schemas
81%
Qualität der Benennung
79%
Risiko der Vergiftung
40%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Befunde (5)

  • HIGHTool poisoning patterns detected
  • MEDIUMTool description contains suspicious base64-like encoded stringin brewman_get_stock_levels
  • MEDIUMTool description contains suspicious base64-like encoded stringin brewman_get_stock_incoming_outgoing
  • MEDIUMTool description contains suspicious base64-like encoded stringin brewman_list_purchase_orders
  • LOWTool 'brewman_get_stock_incoming_outgoing' name length outside 3-30 rangein brewman_get_stock_incoming_outgoing

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~4,245Tokens (Tool-Definitionen)
~2.0 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (3.32% von 128k Kontext)

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-http

Was es kann

Tool-Inventar

Tools (14)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢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

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet14 Tools