Skip to content
MCP server

bag.coffee

Search in-stock specialty coffee from 79 curated roasters, priced per 100 g

Pricing
Freemium
Platforms
API
Runs
Remotely
Version
1.0.0
Listing updated
1 day ago

About bag.coffee

bag.coffee is a freemium MCP server for food and drink. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://api.bag.coffee/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "catalog": {
      "url": "https://api.bag.coffee/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Freemium

Free plan with rate limits; Pro and Partner by arrangement

Prices change. Check bag.coffee before you buy.

bag.coffee 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 to bag.coffee

  1. Let Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions

    Not checked yet
    • Remote
    • Open source
    • 2 GitHub stars
    • E-commerce
  2. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security
  3. Search replacement filters, alarms and batteries, check fit and build a cart link

    • 7 tools
    • Remote
    • Free
    • E-commerce
  4. Fast Food Index

    MCP server

    Live US fast food menu prices, Big Mac index by state and verified price changes

    • 6 tools
    • Remote
    • Free
    • Food and drink
  5. Renta

    MCP server

    Remote MCP server for running an outdoor rental shop on Renta from an AI client

    • Remote
    • Paid
    • E-commerce
  6. Hosted MCP server that returns any Shopify store's products, prices and stock

    Not checked yet
    • 4 tools
    • Remote
    • Paid
    • E-commerce