coffee-addict

Every bag of specialty coffee on sale in New Zealand, re-read nightly from each roaster's shop.

Should I use this

Quality & Safety

A
Description quality
87%
Schema completeness
79%
Naming quality
87%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~457Tokens (tool definitions)
~1.1 KBTypical response size
Minimal attention impact (0.36% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "coffee-addict": {
      "url": "https://coffeeaddict.nz/mcp"
    }
  }
}

Remote endpoints

https://coffeeaddict.nz/mcpstreamable-http

What it can do

Tool inventory

Tools (3)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢search_beans(query, origin, roast_style, roaster, max_price_per_100g, ...)

Search every bag of specialty coffee on sale in New Zealand. Filter by free text (name, roaster, origin, tasting notes), origin, roast style, roaster, price and stock. Results are cheapest per 100g first.

Input Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free text: name, roaster, origin or tasting note.",
      "maxLength": 200
    },
    "origin": {
      "type": "string",
      "description": "Country or region, e.g. 'Ethiopia'.",
      "maxLength": 200
    },
    "roast_style": {
      "type": "string",
      "enum": [
        "espresso",
        "filter",
        "omni"
      ]
    },
    "roaster": {
      "type": "string",
      "description": "Roaster name or slug.",
      "maxLength": 200
    },
    "max_price_per_100g": {
      "type": "number"
    },
    "max_price_nzd": {
      "type": "number"
    },
    "in_stock_only": {
      "type": "boolean",
      "default": true
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "minimum": 1,
      "maximum": 100
    }
  },
  "additionalProperties": false
}
🟢best_deals(kind, limit)

Today's price cuts, new arrivals and cheapest bags per 100g across New Zealand specialty coffee. Every row carries the reason it is on the list, and an empty list carries the reason it is empty.

Input Schema

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "price_cuts",
        "just_dropped",
        "cheapest_per_100g",
        "all"
      ],
      "default": "all"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "minimum": 1,
      "maximum": 25
    }
  },
  "additionalProperties": false
}
⚪roaster_info(roaster, include_beans)

The New Zealand specialty roasters we track: how many bags each has, their cheapest per 100g, their published shipping terms and where they roast. Omit `roaster` for all of them.

Input Schema

{
  "type": "object",
  "properties": {
    "roaster": {
      "type": "string",
      "description": "Name or slug. Omit for all.",
      "maxLength": 200
    },
    "include_beans": {
      "type": "boolean",
      "default": false,
      "description": "Also return that roaster's shelf, up to 200 bags."
    }
  },
  "additionalProperties": false
}

Recommended Prompts

search_research
Search for information about [topic] using coffee-addict
Expected tools: search_beans
find_specific
Find [specific item] using coffee-addict
Expected tools: search_beans

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded3 tools
verifiedversion not recorded3 tools