brewman-mcp-server

An MCP server that wraps the Brewman Web (V7) API so Claude can read and write Brewman data through tools — without ever seeing the raw API token. Built for Flying Tumbler as the fast read/write layer alongside the browser-driven brewman-operator skill (which handles production, duty, ullages, containers, distribution and reports — the things the API can't do).

The token is held as a server environment variable. It is never in code, never in chat, never logged.

What it exposes

Tools (all calls are POST to /webapi/...; the tenant id is injected automatically):

Full API reference (Swagger): https://brewman.premiersystems.com/swagger/index.html

Related MCP server: sevdesk-mcp

Setup

1. Create a dedicated Brewman API user + token

In Brewman, create a new user just for the API (so anything it creates is attributed to "API" in the UI, not to you). Generate an API token from that user's screen and note the tenant (group) id shown there.

2. Configure environment variables

Copy .env.example → .env (local) or set them in your host's project settings:

• BREWMAN_API_TOKEN — the token (secret)

• BREWMAN_TENANT_ID — the tenant/group id

• optional: BREWMAN_BASE_URL, BREWMAN_TENANT_FIELD, TRANSPORT, PORT

3a. Deploy to Vercel (matches the FT Meta MCP setup)

npm install
vercel            # link/deploy
# In the Vercel dashboard: Project → Settings → Environment Variables:
#   BREWMAN_API_TOKEN, BREWMAN_TENANT_ID
vercel --prod

MCP endpoint: https://<your-app>.vercel.app/mcp (rewritten to /api/mcp).

3b. Or run anywhere as a Node service / locally

npm install
npm run build
BREWMAN_API_TOKEN=... BREWMAN_TENANT_ID=... npm start   # http on :3000 -> /mcp

4. Connect it to Claude / Cowork

Add the deployed URL as a custom MCP connector (same way the FT Meta MCP is wired): https://<your-app>.vercel.app/mcp. Then the brewman-operator skill will use these tools for orders/outlets/stock/config and fall back to the browser for everything else.

Verify

# health check
curl https://<your-app>.vercel.app/mcp        # -> {"ok":true,...}

Then from Claude, call brewman_get_user_context — it should return your user + tenant id.

Safety

• Reads are free. Writes (create_order, create/update_outlet, cancel_order, and any write via brewman_request) change live data exactly like the UI — the operator confirms with Patrick before calling them.

• The API is BETA; schemas may change. The dedicated tools cover the common cases; use brewman_request with the Swagger schema for anything else.

• Not available via API (use the browser/brewman-operator skill): production/batches, duty & excise returns, ullages, container tracking, distribution journeys, BI reports.