compatsy 3D printing MCP server
Commit Oct 29, 2026Lets an AI client check 3D printing part compatibility, compare technical specifications, and verify real-time stock and pricing.
Also known as elliot-rosen/compatsy-mcp, compatsy-mcp
- Stars
- 0
- Tools
- 6
- Downloads, 30 days
- —
- Latest version
- 0.1.0
- Last commit
- Oct 29, 2026
- License
- MIT
What is compatsy 3D printing MCP?
compatsy 3D printing lets an AI client check 3D printing part compatibility, compare technical specifications, and verify real-time stock and pricing. It exposes 6 tools, such as search_products, get_product, compare.
Summary generated from the project's README
About compatsy 3D printing MCP server
Compatsy 3D printing provides an MCP server that allows AI clients to verify hardware compatibility and technical specifications for 3D printing components. It covers a wide range of items including printers, nozzles, hotends, build plates, filament, and enclosures. Users can access the service remotely via Streamable HTTP or through a local stdio bridge using npx. No accounts or API keys are required to connect, though calls are subject to per-session rate limits.
The server includes specific tools like search_products for finding items by category, compare for side-by-side technical tables of up to ten products, and check_fit to determine if a part works with a specific machine. It also offers check_stock to retrieve real-time pricing and availability from various merchants. Every fit verdict includes a rule ID and version, while technical specs include their original source and a confidence rating. If a compatibility status is unknown, the tool identifies exactly which specification fields are missing.
What you can do with it
- 1Verify hardware compatibilityAsk the AI if a specific nozzle will fit a particular 3D printer model.
- 2Compare technical specificationsRequest a side-by-side comparison of build volumes and enclosures for different printers.
- 3Check real-time availabilityFind the cheapest hardened nozzles that are currently in stock for a specific machine.
- 4Report data inaccuraciesSubmit a correction if a product specification or price is incorrect.
Written from the project's README. Every use case is checked against a quote from it.
How to install compatsy 3D printing MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall compatsy 3D printing MCP in Claude Code
$ claude mcp add --transport http compatsy-mcp https://compatsy.com/3d-printing/mcpInstall compatsy 3D printing MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"compatsy-mcp": {
"url": "https://compatsy.com/3d-printing/mcp"
}
}
}Install compatsy 3D printing MCP in VS Code
.vscode/mcp.json
{
"servers": {
"compatsy-mcp": {
"type": "http",
"url": "https://compatsy.com/3d-printing/mcp"
}
}
}Install compatsy 3D printing MCP in VS Code CLI
$ code --add-mcp '{"name":"compatsy-mcp","type":"http","url":"https://compatsy.com/3d-printing/mcp"}'Install compatsy 3D printing MCP in Codex
$ codex mcp add compatsy-mcp --url https://compatsy.com/3d-printing/mcpInstall compatsy 3D printing MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.compatsy-mcp] url = "https://compatsy.com/3d-printing/mcp"
Install compatsy 3D printing MCP in Gemini CLI
$ gemini mcp add -s user --transport http compatsy-mcp https://compatsy.com/3d-printing/mcpInstall compatsy 3D printing MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"compatsy-mcp": {
"url": "https://compatsy.com/3d-printing/mcp",
"type": "http"
}
}
}compatsy 3D printing MCP tools 6
Detected from the READMEsearch_productsget_productcomparecheck_fitcheck_stockreport_issue
| search_products | — | |
| get_product | — | |
| compare | — | |
| check_fit | — | |
| check_stock | — | |
| report_issue | — |
Configuration
COMPATSY_MCP_URL
| Name | Description | |
|---|---|---|
| COMPATSY_MCP_URL | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableelliot-rosen/compatsy-mcp is public and reachablegithub.com/elliot-rosen/compatsy-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-29github.com/elliot-rosen/compatsy-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 103 msPass
README
View on GitHubcompatsy-mcp
compatsy answers "does this part fit that machine, and where is it in stock?" Each category has its own MCP endpoint:
| Category | Covers | Endpoint |
|---|---|---|
| 3D printing | printers, nozzles, hotends, build plates, filament, enclosures | https://compatsy.com/3d-printing/mcp |
| Home espresso | machines, tampers, puck screens, distribution tools, dosing funnels, baskets | https://compatsy.com/home-espresso/mcp |
Specs carry their source and confidence, fit verdicts cite the rule that decided them, and prices come with the time they were last verified.
This repo is the quickstart for the hosted MCP server. Nothing runs locally except an optional stdio bridge.
Connect
Remote (preferred). Any client that supports Streamable HTTP:
{ "mcpServers": { "compatsy-3d-printing": { "url": "https://compatsy.com/3d-printing/mcp" } } }
stdio via npx. For clients that only launch local servers:
{ "mcpServers": { "compatsy-espresso": { "command": "npx", "args": ["-y", "github:elliot-rosen/compatsy-mcp"], "env": { "COMPATSY_MCP_URL": "https://compatsy.com/home-espresso/mcp" } } } }
Claude Code: claude mcp add --transport http compatsy-3d-printing https://compatsy.com/3d-printing/mcp
No account or key. Calls are rate limited per session. The bridge defaults to https://compatsy.com/mcp (3D printing); set COMPATSY_MCP_URL to another endpoint from the table.
Tools
| Tool | What it does | Read-only |
|---|---|---|
search_products |
Find products by name or category plus spec filters | yes |
get_product |
Full specs with source and confidence, every offer with verified time | yes |
compare |
Side-by-side spec table for 2 to 10 products | yes |
check_fit |
Verdict for a part and a machine, with the rule id and version, or the missing fields | yes |
check_stock |
Price and availability per merchant, re-verified when over an hour old | yes |
report_issue |
Flag a wrong spec, price or verdict. Reports never edit facts | no |
Example calls
{"name": "search_products", "arguments": {"query": "hardened nozzle 0.4", "category": "nozzle", "limit": 5}}
{"name": "get_product", "arguments": {"product_id": "prusa-mk4s"}}
{"name": "compare", "arguments": {"product_ids": ["bambu-lab-p1s", "prusa-core-one"]}}
{"name": "check_fit", "arguments": {"subject_id": "<nozzle id from search_products>", "target_id": "prusa-mk4s"}}
{"name": "check_stock", "arguments": {"product_id": "prusa-mk4s"}}
{"name": "report_issue", "arguments": {"entity_type": "product", "entity_id": "prusa-mk4s", "field": "nozzle_thread", "claim": "MK4S uses the Nextruder thread"}}
Example prompts that use them well:
- "Will a V6 nozzle fit my Prusa MK4S? If it needs an adapter, say which."
- "Which hardened 0.6 mm nozzles fit a Bambu Lab P1S, cheapest in stock first?"
- "Compare the Core One and the P1S on build volume and enclosure."
- "Which puck screens fit a Breville Barista Express, in stock?"
Verdicts
fits, fits_with_adapter, does_not_fit or unknown. Unknown is an answer: it lists the spec fields that are missing rather than guessing. Every rule needs two independent sources, one from the manufacturer, before it can decide anything.
Editor rules
rules/cursor.mdc and rules/windsurf.md tell Cursor or Windsurf agents when to call compatsy instead of guessing fitment from memory.
Links
- Methodology: https://compatsy.com/3d-printing/methodology and https://compatsy.com/home-espresso/methodology
- Open data: https://compatsy.com/data
- Privacy: https://compatsy.com/3d-printing/privacy
- OpenAPI: https://compatsy.com/api/v1/openapi.json
- Support: support@compatsy.com
compatsy 3D printing MCP questions
How do I add compatsy 3D printing MCP to Claude Code?
Run claude mcp add --transport http compatsy-mcp https://compatsy.com/3d-printing/mcp in your terminal. Add --scope user to make it available in every project.
How do I add compatsy 3D printing MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does compatsy 3D printing MCP provide?
It exposes 6 tools, including search_products, get_product, compare, check_fit, check_stock.
How does the server determine if a part fits a machine?
It provides a verdict based on specific rules, citing the rule ID and version used to decide compatibility.
What happens if the compatibility information is missing?
The server returns an 'unknown' verdict which lists the specific missing specification fields instead of guessing.
Do I need an account or an API key to use this?
No, the service does not require an account or an API key, though calls are rate limited per session.