# compatsy home espresso

> compatsy home espresso is a free MCP server for e-commerce. Check which espresso parts fit your machine, with specs and verified in-stock prices. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API, CLI
- **Website:** https://compatsy.com/home-espresso
- **Repository:** https://github.com/elliot-rosen/compatsy-mcp
- **MCP Registry name:** com.compatsy/home-espresso
- **Categories:** e-commerce
- **Listing updated:** 2026-11-14

## About

Compatsy answers a narrow question for coffee gear: does this part fit that machine, and who has it in stock? The home espresso endpoint covers machines, tampers, puck screens, distribution tools, dosing funnels, baskets and portafilters, and the site lists thousands of machines and hundreds of accessories.

Specs are shown with their source and a confidence level. A fit check returns one of four verdicts: fits, fits with adapter, does not fit or unknown. Each verdict cites the rule id and version that decided it, and unknown lists the missing spec fields instead of guessing. The README says every rule needs two independent sources, one of them from the manufacturer.

Prices come with the time they were last verified, and stock checks re-verify any offer older than an hour. Outbound links are affiliate links, but the site says the default link is the lowest in-stock USD price regardless of commission. The same project also runs a 3D printing endpoint. Nothing runs locally apart from an optional stdio bridge, and no account or key is needed.

## Features

- **Fit verdicts with rules:** Returns fits, fits with adapter, does not fit or unknown, citing the deciding rule id and version.
- **Specs with provenance:** Each spec carries its source and a confidence level.
- **Side-by-side comparison:** Compares two to ten products in one spec table.
- **Live stock and prices:** Shows price and availability per merchant, re-verified when older than an hour.
- **Issue reporting:** Lets a client flag a wrong spec, price or verdict without editing facts directly.
- **Editor rules:** Ships Cursor and Windsurf rule files that tell agents to call it instead of guessing fitment.

## Good for

- Check whether a puck screen fits a specific espresso machine
- Find baskets or tampers that fit a portafilter and are in stock
- Compare two espresso machines on specs
- Find the cheapest in-stock merchant for a part
- Stop an assistant guessing accessory compatibility from memory

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http home-espresso https://compatsy.com/home-espresso/mcp
```

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

```sh
https://compatsy.com/home-espresso/mcp
```

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

```json
{
  "mcpServers": {
    "home-espresso": {
      "url": "https://compatsy.com/home-espresso/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "home-espresso": {
      "type": "http",
      "url": "https://compatsy.com/home-espresso/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "home-espresso": {
      "serverUrl": "https://compatsy.com/home-espresso/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "home-espresso": {
      "type": "http",
      "url": "https://compatsy.com/home-espresso/mcp"
    }
  }
}
```

## Tools

- `search_products`: Find products by name or category plus spec filters.
- `get_product`: Full specs with source and confidence, plus every offer with verified time.
- `compare`: Side-by-side spec table for 2 to 10 products.
- `check_fit`: Verdict for a part and a machine, with rule id and version, or the missing fields.
- `check_stock`: Price and availability per merchant, re-verified when over an hour old.
- `report_issue`: Flag a wrong spec, price or verdict; reports never edit facts.

## FAQ

### Do I need an account or API key?

No. The README says no account or key is needed, and calls are rate limited per session.

### What does an unknown verdict mean?

It means the rules could not decide, and the response lists the spec fields that are missing rather than guessing.

### How fresh are the prices?

Each price carries its last verified time, and the stock tool re-verifies offers older than an hour.

### Can I use it from a client that only launches local servers?

Yes. An optional npx stdio bridge points at the endpoint set in COMPATSY_MCP_URL.

### Is compatsy home espresso free?

Yes. compatsy home espresso is free to use.

### How do I add compatsy home espresso to Claude Code?

Run this command in your terminal: claude mcp add --transport http home-espresso https://compatsy.com/home-espresso/mcp

### What are the best alternatives to compatsy home espresso?

The closest alternatives to compatsy home espresso are O'So MCP Server for PrestaShop, SecureCloud, MadMax Trade Supply parts, Renta and Shopify MCP Server (any store).

## 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.
- [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.
- [Suawave](https://ai-powered.com/mcp/suawave): Suawave is a paid MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/compatsy-home-espresso
