partfits
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
partfits
Looking for the right battery, screen or keyboard for a laptop should not mean guessing a part number and hoping. partfits is a small forwarding client for the hosted Laptop Part Finder service: the tool list is served from your own machine using the captured definitions, and each call is sent upstream, with the service's answer returned exactly as it arrived.
All six of the service's captured tools are exposed. You can search the OEM parts catalogue by free text, browse the models the catalogue covers, pull every documented part for one model, look up a part number and see every model it fits, and find and read step-by-step replacement guides drawn from official service manuals. Every tool only reads; the tools return source URLs, and nothing is ordered, quoted or submitted anywhere.
The tools
search_parts— Search OEM replacement parts and laptop models by free text (a model name, a part number, or a part type such as battery or screen) viaquery. Returns part numbers with the official source URL for each fit. An optionaltypefilter and alimit(1 to 50) narrow the result.list_models— List the laptop and Chromebook models the catalogue covers. Optionalbrandandcategory(chromebookorbusiness-laptop) filters narrow the list. No required fields.get_model_parts— Get every documented OEM replacement part for one laptop model viamodel(a slug such aslenovo-thinkpad-t490or a plain name). Ambiguous names return candidate models instead of a guess. An optionalclientname attributes outbound affiliate links.get_part_fits— Look up an OEMpart_numberand list every laptop model it is documented to fit, with the official source URL for each fit. An optionalclientname works the same way as above.find_repair_guides— Find step-by-step replacement guides (battery, SSD, RAM, keyboard, fan, speakers, RTC battery, WLAN and more) paraphrased from official service manuals. Filter bymodel,componentor free-textquery; topics not yet covered are listed too. No required fields.get_repair_guide— Read one guide by itsslug: full Markdown steps with page citations, the official manual URL, HP service classification and scope restrictions.
Related MCP server: CHARM
Install and run
As an MCP server via npm:
npx -y @reneturcios/partfits mcpMCP client configuration:
{
"mcpServers": {
"partfits": {
"command": "npx",
"args": ["-y", "@reneturcios/partfits", "mcp"]
}
}
}As a container:
docker run -i ghcr.io/cloudcorprecords/partfits
docker run --rm ghcr.io/cloudcorprecords/partfits search_parts '{"query":"ThinkPad T490 battery"}'CLI
A single binary covers both the command line and the MCP server. Every tool is a subcommand whose one argument is a JSON string of that tool's inputs:
partfits search_parts '{"query":"ThinkPad T490 battery"}'
partfits list_models '{"brand":"Lenovo"}'
partfits get_model_parts '{"model":"lenovo-thinkpad-t490"}'
partfits get_part_fits '{"part_number":"L18M3PF1"}'
partfits find_repair_guides '{"component":"battery"}'
partfits get_repair_guide '{"slug":"hp-elitebook-840-g6-battery-replacement"}'
partfits --versionExit codes: 0 for a successful forwarded call, 1 when the result that comes back is an error, and 2 for usage mistakes like an unknown subcommand or a JSON argument that does not parse.
Configuration
LAPTOPPARTFINDER_MCP_URL— Replaces the upstream endpoint. Defaults to the pinned hosted endpoint,https://laptoppartfinder.com/mcp. (This override variable is a reconstruction introduced by this rebuild.)
The Laptop Part Finder registry record lists no headers for its remote, so partfits never attaches an authentication header — every call goes upstream keyless.
When the upstream cannot answer — it returns a JSON-RPC error, answers with a non-2xx status, sends a body that cannot be read, or the request itself fails — the caller receives an error result whose text begins with partfits error:.
How forwarding works
The first call of a process opens a session against the upstream: an initialize request (protocol version 2025-03-26), a notifications/initialized notification, and then the tools/call. If the service issues an Mcp-Session-Id header during initialize, partfits repeats it on subsequent requests and keeps reusing that one session until the process ends. Replies are understood in both plain JSON and server-sent-events framing. Successful results are passed through untouched, isError flag and any extra fields included.
Development
npm install
npm run build # tsc -> dist/ (dist/cli.js is the bin)
npm test # tsx --test test/*.test.ts — stubbed upstream, no network
npm run dev # run the CLI from sourceThe suite compares the served tool list against the captured surface tool for tool, walks the session handshake and its reuse, proves no Authorization header is sent under any environment, and confirms that arguments travel upstream unchanged and results return unchanged.
License
MIT — see LICENSE. Copyright (c) 2026 Rene Turcios.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Free, read-only OEM laptop part numbers, models they fit, and repair guides. No API key required.
Search real parts with datasheet-provenance specs, check compatibility and compose priced BOMs.
Calibrated IT hardware parts reference: PN normalization, search, cross-references, cited facts.
Read-only parts catalogue for power electronics: search, selection, cross-reference.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceDeterministic industrial parts replacement engine with official catalogs and expert accuracy checksMIT
- AlicenseNot gradedqualityDmaintenanceProvides AI agents with authoritative OEM automotive repair data including part numbers, torque specs, fluid capacities, and service procedures for vehicles 1982-2013 across 80+ makes, sourced from factory service manuals.MIT
- AlicenseNot gradedqualityCmaintenanceEnables searching current used car, truck, and motorcycle parts in the US, resolving vehicles via VIN, and retrieving part listings with source attribution, through read-only MCP tools.Apache 2.0

MyLeadTech MCPofficial
AlicenseAqualityBmaintenanceEnables users to resolve HVAC model and nameplate references, search OEM documents for fault codes and specifications, and receive written answers with page-level citations for Carrier, Trane, and Lennox equipment.5MIT