BrewMan MCP by usefulapi

Read orders, outlets, stock and purchase orders, and create or cancel orders in BrewMan.

¿Debería usar esto?

Calidad y seguridad

B
Calidad de la descripción
100%
Integridad del esquema
81%
Calidad de los nombres
79%
Riesgo de envenenamiento
40%
Coincidencia de permisos
100%
Cumplimiento del protocolo
100%

Hallazgos (5)

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

Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.

Costo de contexto

~4,245Tokens (definiciones de herramientas)
~2.0 KBTamaño de respuesta típico
Impacto significativo en la atención (3.32% del contexto de 128k)

Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.

Instalar

Instalación con un clic

Agrega esto a tu archivo `claude_desktop_config.json`:

{
  "mcpServers": {
    "brewman": {
      "url": "https://brewman.usefulapi.io/mcp"
    }
  }
}

Puntos de conexión remotos

https://brewman.usefulapi.io/mcpstreamable-http

Qué puede hacer

Inventario de herramientas

Herramientas (14)

🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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"
}

Comunidad

Califica este servidor

Evidencia

Observaciones recientes

verificadoversión no registrada14 herramientas