MCP Quickstart

Last Updated: March 2026

This guide gets BrewLogica's MCP server running in under 5 minutes. You will configure your AI assistant, verify the connection with a live tool call, and run through the most common workflows.

Before You Begin

You need three things before starting:

1 A BrewLogica account — download the app on iOS (Android coming soon)
2 A Pro subscription — MCP API access requires a Pro plan ($49.99/year)
3 Node.js 18+ installed — required to run the npx MCP remote proxy

Step 1: Generate Your API Token

Visit brewlogica.app/tokens, sign in with your BrewLogica account, and click Generate. Your token will start with bl_.

Copy your token immediately — it is only shown once.

Store it in a password manager or secure notes app. If you lose it, generate a new one and revoke the old token.

Step 2: Add to Your MCP Client

Replace YOUR_TOKEN_HERE with your actual token in the configuration for your client below.

Claude Code

Create or edit ~/.mcp.json (global) or .mcp.json in your project root:

{
  "mcpServers": {
    "brewlogica": {
      "command": "npx",
      "args": [
        "-y",
        "@anthropic-ai/mcp-remote",
        "https://api.brewlogica.app/mcp",
        "--header",
        "Authorization: Bearer YOUR_TOKEN_HERE"
      ]
    }
  }
}

Claude Desktop

Edit your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "brewlogica": {
      "command": "npx",
      "args": [
        "-y",
        "@anthropic-ai/mcp-remote",
        "https://api.brewlogica.app/mcp",
        "--header",
        "Authorization: Bearer YOUR_TOKEN_HERE"
      ]
    }
  }
}

Restart Claude Desktop after saving the file.

Cursor

Go to Settings → Features → MCP Servers and add a new server with the same configuration. Cursor accepts the same JSON format as Claude Code.

Step 3: Verify the Connection

Restart your AI client, then ask it to list your beans. This is the fastest way to confirm the MCP server is responding:

"List my beans in BrewLogica"

The assistant will call list_beans and return your collection. If you have no beans yet, you'll get an empty list — that's still a successful connection.

Success looks like: The assistant acknowledges it connected to BrewLogica and returns data (or an empty list). It should not say "I can't connect to external services."

Example Tool Calls

The following prompts trigger specific MCP tools. You can use these verbatim or adapt them.

list_beans

List all beans in your collection:

"What coffees do I have in my collection?"

list_beans(limit: 50)
→ Returns: array of beans with name, roaster, origin, process

create_brew

Log a new brew with natural language:

"Log an espresso: 18g in, 36g out, 28 seconds, a little sour"

create_brew(method: "espresso", dose_grams: 18, yield_grams: 36, time_seconds: 28, notes: "a little sour")
→ Returns: brew_id, created timestamp

list_brews

Review recent brew history with optional filters:

"Show my last 10 espressos"

list_brews(method: "espresso", limit: 10)
→ Returns: array of brews with dose, yield, time, rating, notes

create_bean

Add a new coffee to your bean library:

"Add Onyx Coffee Lab Tropical Weather, natural process, blueberry and chocolate notes"

create_bean(name: "Tropical Weather", roaster: "Onyx Coffee Lab", process: "natural", tasting_notes: "blueberry, chocolate")
→ Returns: bean_id, created details

get_suggestions

Get AI-powered brewing parameter suggestions:

"Suggest V60 parameters for my Ethiopian natural"

get_suggestions(method: "v60", bean_id: "uuid-of-bean")
→ Returns: dose, ratio, grind recommendation, technique tips

get_stats

Get brewing analytics for a time period:

"How many brews did I make this month?"

get_stats(period: "month")
→ Returns: total brews, method breakdown, avg rating, top beans

Troubleshooting

"I can't connect to external services"

The MCP server is not configured. Verify your .mcp.json exists in the correct location and restart your AI client.

401 Unauthorized

Your token is invalid or has been revoked. Visit brewlogica.app/tokens to generate a new one.

npx: command not found

Install Node.js 18 or later from nodejs.org. The npx command is included with Node.js.

Tools appear but return no data

Your BrewLogica account exists but is empty. Log a brew in the iOS app first, or use create_bean and create_brew via MCP to add data.

Need more help? See the full Getting Started guide or the complete MCP Tools Reference.