Skip to content
MCP server

compatsy home espresso

Check which espresso parts fit your machine, with specs and verified in-stock prices

Install
Pricing
Free
Platforms
Web, API, CLI
Runs
Remotely
Version
0.1.0
Listing updated
3 days ago

About compatsy home espresso

compatsy home espresso is a free MCP server for e-commerce. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://compatsy.com/home-espresso/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "home-espresso": {
      "url": "https://compatsy.com/home-espresso/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

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

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

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

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

Tools this server provides (6)

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

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.

What it does

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

Pricing

Free

No account or key required; calls are rate limited per session

Prices change. Check compatsy.com before you buy.

compatsy home espresso 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 to compatsy home espresso

  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. Renta

    MCP server

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

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

    Not checked yet
    • 4 tools
    • Remote
    • Paid
    • E-commerce
  6. repairinfo

    MCP server

    Repairability scores and spare-parts years for EU appliances and electronics

    • 4 tools
    • Remote
    • Freemium
    • Analytics and data