# BrewMan MCP by usefulapi

> BrewMan MCP by usefulapi is an MCP server. Read orders, outlets, stock and purchase orders, and create or cancel orders in BrewMan. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/brewman/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/brewman
- **MCP Registry name:** io.usefulapi/brewman
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http brewman https://brewman.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://brewman.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "brewman": {
      "type": "http",
      "url": "https://brewman.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "brewman": {
      "serverUrl": "https://brewman.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "brewman": {
      "type": "http",
      "url": "https://brewman.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `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.
- `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.
- `brewman_get_outlet`: Get one outlet by id, with its contact, address, price list and credit terms. BrewMan API: POST /webapi/Outlet/v1/GetOutlet.
- `brewman_list_orders`: 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.
- `brewman_get_order`: Get one order by id, with its header and lines. BrewMan API: POST /webapi/Order/v2/GetOrder.
- `brewman_list_items`: 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.
- `brewman_get_stock_levels`: 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.
- `brewman_get_stock_incoming_outgoing`: 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.
- `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.
- `brewman_list_purchase_orders`: List purchase orders that match a filter (status, supplier, dates). Dates are inclusive yyyy-mm-dd. BrewMan API: POST /webapi/PurchaseOrder/v1/GetPurchaseOrdersByFilter.
- `brewman_create_order`: 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.
- `brewman_add_order_line`: 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.
- `brewman_delete_order_lines`: Delete one or more lines from an order. This cannot be undone through the API. BrewMan API: POST /webapi/Order/v1/DeleteLinesFromOrder.
- `brewman_cancel_order`: Cancel an order and give the reason. A cancelled order cannot be reopened through the API. BrewMan API: POST /webapi/Order/v1/CancelOrder.

## FAQ

### How do I add BrewMan MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http brewman https://brewman.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/brewman-mcp-by-usefulapi
