# bag.coffee

> bag.coffee is a freemium MCP server for food and drink. Search in-stock specialty coffee from 79 curated roasters, priced per 100 g. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API
- **Website:** https://bag.coffee/llms.txt
- **MCP Registry name:** coffee.bag/catalog
- **Categories:** food and drink, e-commerce
- **Listing updated:** 2026-11-16

## About

bag.coffee is a catalogue rather than a shop. Its crawler checks every coffee from a hand-picked set of specialty roasters about hourly, converts prices to US dollars per 100 g, and links each bag to the roaster's own store. The site said 1,051 coffees were in stock on 15 November 2026 and has tracked releases and sell-out speed since early 2026.

The MCP server at api.bag.coffee/mcp uses the same API key as the REST API, sent as a bearer token. Search filters include words, roaster, origin, process, tasting notes, price per 100 g and the shipping country, and each result says where its roaster ships. Another tool returns a week's drops, and one lists roasters with their place, shipping countries, in-stock count and usual release day.

The free plan allows 60 requests a minute, 60 coffee list reads an hour and 2,000 coffees a day. Pro and Partner plans are by arrangement, and the API terms ask for credit and forbid mirroring or resale.

## Features

- **In-stock search:** Filters by roaster, origin, process, notes, price and shipping country.
- **Price per 100 g:** Normalises prices across roasters in US dollars.
- **Weekly drops:** Lists what each roaster released in a given ISO week.
- **Roaster directory:** Place, shipping countries, stock count and usual drop day.
- **Hourly checks:** Availability is refreshed hourly.
- **Read-only:** Four tools, all read-only.

## Good for

- Finding a washed Ethiopian that ships to your country
- Seeing what dropped this week
- Comparing price per 100 g across roasters
- Checking when a roaster usually releases coffee

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http catalog https://api.bag.coffee/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.bag.coffee/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "catalog": {
      "url": "https://api.bag.coffee/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "catalog": {
      "type": "http",
      "url": "https://api.bag.coffee/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "catalog": {
      "serverUrl": "https://api.bag.coffee/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "catalog": {
      "type": "http",
      "url": "https://api.bag.coffee/mcp"
    }
  }
}
```

## Tools

- `search_coffees`: Find coffees by words, roaster, origin, process, notes, price and shipping country
- `get_coffee`: One coffee by id, slug or URL
- `list_roasters`: Every roaster with place, shipping and usual drop day
- `whats_new`: A week's drops

## FAQ

### Does bag.coffee sell coffee?

No. Every buy link opens the roaster's own shop.

### Do I need a key?

Yes, an API key as a bearer token, from the account page.

### What are the free limits?

60 requests a minute, 60 list reads an hour and 2,000 coffees a day per key.

### Can I resell the data?

No. The API terms forbid mirroring or resale outside a Partner plan.

### Is bag.coffee free?

bag.coffee has a free plan, with paid plans for more usage or features.

### How do I add bag.coffee to Claude Code?

Run this command in your terminal: claude mcp add --transport http catalog https://api.bag.coffee/mcp

### What are the best alternatives to bag.coffee?

The closest alternatives to bag.coffee are O'So MCP Server for PrestaShop, SecureCloud, MadMax Trade Supply parts, Fast Food Index and Renta.

## Alternatives

- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [Fast Food Index](https://ai-powered.com/mcp/fast-food-index): Fast Food Index is a free MCP server for food and drink.
- [Renta](https://ai-powered.com/mcp/renta): Renta is a paid MCP server for e-commerce.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.
- [repairinfo](https://ai-powered.com/mcp/repairinfo): repairinfo is a freemium MCP server for analytics and data.
- [bxmcp — 1C-Bitrix site assistant](https://ai-powered.com/mcp/bxmcp-1c-bitrix-site-assistant): bxmcp — 1C-Bitrix site assistant is a freemium MCP server for e-commerce.

---
Source: https://ai-powered.com/mcp/bag-coffee
