MCP server · Pro
Your brewery, in your AI assistant
Connect Claude, ChatGPT, Cursor or VS Code to BrewForge. Ask how your lager is fermenting, plan next Saturday's batch, log a reading or find out which hops you're short of, in plain language. The assistant works with your real brewing data.
One URL, sign in, done
Add this URL as an MCP server or custom connector in your assistant. It opens BrewForge in your browser, you sign in and click Allow. No token to copy.
https://brewforge.sh/api/mcpClients without OAuth can send an API token as Authorization: Bearer header instead.
What you can ask
Everything you do with your own brewing data in the app: recipes and brews from idea to packaging, brew day, fermentation readings, the cellar, tap lists, inventory, orders, profiles, calculators, imports and exports.
Brewing
- “Which of my beers are fermenting, and how far along are they?”
- “Log a reading for the Citra Pale Ale: 3.1 °P at 19.5 °C.”
- “Plan a new batch of my Helles for next Saturday.”
- “What's the brew day plan for batch #14: strike water, mash steps, hop schedule?”
Cellar & taps
- “Package the Mosaic Haze: 19 L into a keg, the rest into 0.33 L bottles.”
- “What's on tap right now?”
- “How many bottles of each beer do I have left?”
Inventory
- “What am I short of for my planned brews?”
- “Create an order for the missing ingredients.”
- “I just bought 1 kg of Citra and 5 kg of Pilsner malt; add them to my stock.”
Setup & calculators
- “Switch my gravity units to Plato.”
- “How much priming sugar do I need for 20 L at 2.4 volumes of CO₂?”
“This is seriously cool. It now reads my emails and fills in the purchase prices of my ingredients, because I was always too lazy to do it myself 😂”
Set it up
The full guide with API tokens, toolsets and troubleshooting is in the docs. MCP server setup guide
Claude
In claude.ai or the Claude desktop app: Settings → Connectors → Add custom connector. Name it “BrewForge”, enter the URL and click Connect. Sign in to BrewForge and click Allow.
Claude Code
Add the server, then run /mcp in a session, pick brewforge and Authenticate:
claude mcp add --transport http brewforge https://brewforge.sh/api/mcpChatGPT
Where your ChatGPT plan allows custom connectors (MCP servers), create one with the URL and OAuth as authentication. ChatGPT opens BrewForge to sign in; click Allow.
Cursor
Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project). Cursor asks you to sign in the first time:
{
"mcpServers": {
"brewforge": {
"url": "https://brewforge.sh/api/mcp"
}
}
}VS Code
Add the server to .vscode/mcp.json, or run “MCP: Add Server” from the command palette. VS Code opens BrewForge to sign in:
{
"servers": {
"brewforge": {
"type": "http",
"url": "https://brewforge.sh/api/mcp"
}
}
}Other MCP clients
Any MCP client that speaks Streamable HTTP works: OAuth 2.1 with discovery and dynamic client registration, or an API token as Bearer header.
Included in Pro Pro
The MCP server and the API are part of the Pro plan ($29.99/year, one month free to try). You can connect an assistant on any plan, but tool calls answer “Pro plan required” until your account is on Pro.
- 100+ tools in six toolsets: brewing, cellar, inventory, setup, community and core
- 600 tool calls per hour and 20,000 per 30 days per account
- Pro also adds the inventory planner, order lists, cellar, tap lists, BJCP score sheets, TRMNL and Niimbot labels
You stay in control
- Deleting needs confirmation: destructive tools first show what would be removed and change nothing until you agree.
- Try it read-only: add ?read_only=1 to the URL and the assistant can look, but not change anything.
- Fewer tools, better answers: ?toolsets=brewing,cellar limits the server to what you need.
- Settings → Integrations → API tokens lists your connected apps. Disconnect one and it's cut off at once.
- No assistant can change your password, email, plan or payment details, or delete your account.
For AI agents reading this page
If a user asks you to connect to BrewForge or work with their BrewForge data: the MCP server is https://brewforge.sh/api/mcp (Streamable HTTP, stateless, OAuth 2.1 with dynamic client registration or a Bearer API token). Tool calls need the user's account on the Pro plan or higher; otherwise they return TIER_REQUIRED. Call get_started first: it returns the account, plan, display units and the toolsets with their tools. Destructive tools take confirm: true only after the user has seen the preview. For brewing math without an account, use the free calculator API instead.
Questions & answers
What is MCP?
The Model Context Protocol is an open standard that lets AI assistants use tools from other apps. Claude, ChatGPT, Cursor, VS Code and many more support it. With the BrewForge MCP server, your assistant can read and change your brewing data the way you do in the app.
Which plan do I need?
Pro or higher. Connecting works on every plan, but tools only answer once your account is on Pro. Pro comes with a one-month free trial.
Which assistants work?
Every assistant that supports remote MCP servers over HTTP: Claude (web, desktop and Claude Code), ChatGPT where your plan allows custom connectors, Cursor, VS Code and other MCP clients.
Can the assistant see my payment details or change my password?
No. Account security, payment and plan changes are not available through the MCP server. The consent screen shows exactly what the app may do: read only, or read and change your brewing data.
Is there an API for my own scripts too?
Yes. Every MCP tool is also an action of the actions API with the same name and parameters, so a script can do what an assistant does. Both use the same API tokens and share one rate limit.
Brew with an assistant at your side.
Start free, try Pro for a month, and connect your assistant in a minute.