# MCP Quickstart — BrewLogica

Last Updated: March 2026

Get BrewLogica's MCP server running in under 5 minutes.

## Prerequisites

1. A BrewLogica account (iOS)
2. A Pro subscription ($49.99/year) — MCP API access requires Pro
3. Node.js 18 or later

## Step 1: Generate Your API Token

Visit [https://brewlogica.app/tokens](https://brewlogica.app/tokens), sign in, and click Generate. Your token starts with `bl_`. Copy it immediately — it is only shown once.

## Step 2: Add to Your MCP Client

Replace `YOUR_TOKEN_HERE` with your actual token.

### Claude Code (~/.mcp.json or project .mcp.json)

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

### Claude Desktop (claude_desktop_config.json)

Same JSON as above. File locations:

* macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

* Windows: %APPDATA%\Claude\claude_desktop_config.json

### Cursor

Settings → Features → MCP Servers → add the same configuration.

## Step 3: Verify the Connection

Restart your AI client and ask: "List my beans in BrewLogica"

This calls `list_beans` and returns your collection (or an empty list if you haven't added any beans yet — still a successful connection).

## Example Tool Calls

### list_beans

Prompt: "What coffees do I have in my collection?"
Tool: `list_beans(limit: 50)`

### create_brew

Prompt: "Log an espresso: 18g in, 36g out, 28 seconds, a little sour"
Tool: `create_brew(method: "espresso", dose_grams: 18, yield_grams: 36, time_seconds: 28, notes: "a little sour")`

### list_brews

Prompt: "Show my last 10 espressos"
Tool: `list_brews(method: "espresso", limit: 10)`

### create_bean

Prompt: "Add Onyx Coffee Lab Tropical Weather, natural process, blueberry and chocolate notes"
Tool: `create_bean(name: "Tropical Weather", roaster: "Onyx Coffee Lab", process: "natural", tasting_notes: "blueberry, chocolate")`

### get_suggestions

Prompt: "Suggest V60 parameters for my Ethiopian natural"
Tool: `get_suggestions(method: "v60", bean_id: "uuid-of-bean")`

### get_stats

Prompt: "How many brews did I make this month?"
Tool: `get_stats(period: "month")`

## Troubleshooting

**"I can't connect to external services"**
MCP server is not configured. Check your .mcp.json location and restart your AI client.

**401 Unauthorized**
Token is invalid or revoked. Generate a new one at [https://brewlogica.app/tokens](https://brewlogica.app/tokens)

**npx: command not found**
Install Node.js 18+ from nodejs.org

**Tools appear but return no data**
Your account is empty. Use `create_bean` or `create_brew` to add data, or log from the iOS app first.

## Related Documentation

* Full Getting Started: [https://brewlogica.app/docs/getting-started](https://brewlogica.app/docs/getting-started)

* Complete Tool Reference: [https://brewlogica.app/docs/tools](https://brewlogica.app/docs/tools)

* Rate Limits: [https://brewlogica.app/docs/rate-limits](https://brewlogica.app/docs/rate-limits)

* Security: [https://brewlogica.app/docs/security](https://brewlogica.app/docs/security)