Laptop Part Finder MCP
An official MCP server providing read-only access to a directory of OEM replacement part numbers and fits for Chromebooks and business laptops. It allows agents to search parts, list models, retrieve specific model parts, find part fits, and access repair guides, with every result citing its source URL and confidence level.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://laptoppartfinder.com/mcpWhat you can do with it
- Find laptop replacement parts by model
- Search for specific OEM part numbers
- Retrieve documented part-to-model fits
- Access official repair guides
Source and maintenance
Protocol and capabilities
- Server
- laptop-part-finder 1.0.0
- MCP protocol
- 2025-06-18
- Tools
- 7 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
7 advertised
search_parts — Search laptop parts
Search OEM replacement parts and laptop models by free text (model name, part number, part type such as battery or screen). Returns part numbers with the official source URL for each fit. Each part has lpf_url (its LPF page) and buy_links; follow buy_links_hint. Each fit has confidence: oem_manual, retailer or unverified.
{
"type": "object",
"required": [
"query"
],
"properties": {
"type": {
"type": "string",
"description": "Optional part type filter, e.g. Battery, Screen, Keyboard, Power Adapter"
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1
},
"query": {
"type": "string",
"description": "e.g. \"ThinkPad T490 battery\" or \"L18M3PF1\""
}
}
}{
"type": "object",
"required": [
"query",
"models",
"parts"
],
"properties": {
"mode": {
"enum": [
"model_exact",
"no_model_match",
"needs_clarification",
"no_match"
],
"type": "string"
},
"type": {
"type": [
"string",
"null"
]
},
"parts": {
"type": "array",
"items": {
"type": "object",
"required": [
"part_number"
],
"properties": {
"url": {
"type": "string"
},
"fits": {
"type": "array",
"items": {
"type": "object",
"required": [
"model"
],
"properties": {
"model": {
"type": "string"
},
"confidence": {
"enum": [
"oem_manual",
"retailer",
"unverified"
],
"type": "string"
},
"model_name": {
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"constraints": {
"type": [
"string",
"null"
]
},
"confidence_note": {
"type": "string"
}
}
}
},
"name": {
"type": "string"
},
"type": {
"type": "string"
},
"brand": {
"type": [
"string",
"null"
]
},
"api_url": {
"type": "string"
},
"lpf_url": {
"type": "string"
},
"buy_links": {
"type": "array",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string"
},
"kind": {
"type": "string"
},
"label": {
"type": "string"
},
"merchant": {
"type": "string"
},
"affiliate": {
"type": "boolean"
}
}
}
},
"confidence": {
"enum": [
"oem_manual",
"retailer",
"unverified"
],
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"part_number": {
"type": "string"
},
"confidence_note": {
"type": "string"
}
}
}
},
"query": {
"type": "string"
},
"models": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"name"
],
"properties": {
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"api_url": {
"type": "string"
},
"aue_date": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"fit_count": {
"type": "integer"
},
"source_url": {
"type": [
"string",
"null"
]
},
"manufacturer": {
"type": "string"
},
"release_year": {
"type": [
"integer",
"null"
]
}
}
}
},
"covered": {
"type": "boolean"
},
"license": {
"type": "string"
},
"message": {
"type": "string"
},
"part_type": {
"type": [
"string",
"null"
]
},
"terms_url": {
"type": "string"
},
"brand_note": {
"type": "string"
},
"fit_status": {
"enum": [
"no_documented_fit"
],
"type": "string",
"description": "Present when there is no fit or no result: LPF has no OEM document for it. Never means incompatible."
},
"attribution": {
"type": "string"
},
"request_url": {
"type": "string"
},
"suggestions": {
"type": "object",
"properties": {
"tips": {
"type": "array",
"items": {
"type": "string"
}
},
"request_url": {
"type": "string"
},
"closest_models": {
"type": "array",
"items": {
"type": "object"
}
},
"browse_models_url": {
"type": "string"
}
}
},
"total_parts": {
"type": "integer"
},
"absence_note": {
"type": "string"
},
"data_revision": {
"type": "string"
},
"resolved_model": {
"type": "object"
},
"candidate_count": {
"type": "integer"
},
"clarifying_question": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false
}resolve_request — Resolve a vague part request
Turn a vague request such as "T490 battery" or "surface pro 11 screen" (or a part number with or without dashes) into a model, a part type and a short candidate list. If the model name is not specific enough (5G vs Wi-Fi, Intel vs AMD, generation) or a screen differs by touch, it returns status needs_clarification with ONE clarifying_question: ask the user that question instead of guessing.
{
"type": "object",
"required": [
"query"
],
"properties": {
"type": {
"type": "string",
"description": "Optional part type, e.g. Battery"
},
"query": {
"type": "string",
"description": "e.g. \"T490 battery\", \"surface pro 11 screen\", \"L40094001\""
}
}
}{
"type": "object",
"required": [
"status",
"query"
],
"properties": {
"kind": {
"enum": [
"part_number",
"concept"
],
"type": "string"
},
"mode": {
"enum": [
"no_match"
],
"type": "string"
},
"next": {
"type": "object"
},
"part": {
"type": "object",
"required": [
"part_number"
],
"properties": {
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"type": {
"type": "string"
},
"brand": {
"type": [
"string",
"null"
]
},
"api_url": {
"type": "string"
},
"lpf_url": {
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"part_number": {
"type": "string"
}
}
},
"match": {
"type": "string"
},
"model": {
"type": "object",
"required": [
"slug"
],
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"manufacturer": {
"type": "string"
}
}
},
"query": {
"type": "string"
},
"status": {
"enum": [
"resolved",
"needs_clarification",
"not_found"
],
"type": "string"
},
"license": {
"type": "string"
},
"message": {
"type": "string"
},
"part_type": {
"type": [
"string",
"null"
]
},
"terms_url": {
"type": "string"
},
"brand_note": {
"type": "string"
},
"candidates": {
"type": "array",
"items": {
"type": "object"
}
},
"fit_status": {
"enum": [
"no_documented_fit"
],
"type": "string",
"description": "Present when there is no fit or no result: LPF has no OEM document for it. Never means incompatible."
},
"attribution": {
"type": "string"
},
"request_url": {
"type": "string"
},
"suggestions": {
"type": "object",
"properties": {
"tips": {
"type": "array",
"items": {
"type": "string"
}
},
"request_url": {
"type": "string"
},
"closest_models": {
"type": "array",
"items": {
"type": "object"
}
},
"browse_models_url": {
"type": "string"
}
}
},
"absence_note": {
"type": "string"
},
"data_revision": {
"type": "string"
},
"confidence_doc": {
"type": "string"
},
"candidate_count": {
"type": "integer"
},
"clarifying_question": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false
}list_models — List laptop models
List laptop and Chromebook models covered, optionally filtered by brand (e.g. Lenovo, Dell, HP) or category (chromebook, business-laptop; only explicitly classified models match). Paginated: 20 per page by default; pass next_cursor as cursor to get the next page. total gives the full count.
{
"type": "object",
"properties": {
"brand": {
"type": "string"
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Page size (default 20)"
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page"
},
"category": {
"enum": [
"chromebook",
"business-laptop"
],
"type": "string"
}
}
}{
"type": "object",
"required": [
"total",
"count",
"models"
],
"properties": {
"count": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"total": {
"type": "integer"
},
"cursor": {
"type": [
"string",
"null"
]
},
"models": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"name"
],
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"api_url": {
"type": "string"
},
"category": {
"type": [
"string",
"null"
]
},
"fit_count": {
"type": "integer"
},
"manufacturer": {
"type": "string"
}
}
}
},
"license": {
"type": "string"
},
"terms_url": {
"type": "string"
},
"fit_status": {
"enum": [
"no_documented_fit"
],
"type": "string",
"description": "Present when there is no fit or no result: LPF has no OEM document for it. Never means incompatible."
},
"attribution": {
"type": "string"
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"absence_note": {
"type": "string"
},
"data_revision": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false
}get_model_parts — Get parts for a model
Get every documented OEM replacement part for one laptop model, with constraints and the official source URL for each fit. Accepts a model slug (from list_models) or model name. If the name is ambiguous (e.g. "T14") it returns status "ambiguous" with candidate models instead of guessing; ask the user to choose, then call again with the slug. When the model has 2+ documented screen parts, panel_options {count, part_numbers, differs_by, connector_documented, advice} says so: tell the user to check their current panel part number or connector before ordering a screen. Each part has lpf_url (its LPF page) and buy_links; follow buy_links_hint. Each fit has confidence: oem_manual, retailer or unverified.
{
"type": "object",
"required": [
"model"
],
"properties": {
"type": {
"type": "string",
"description": "Optional part type filter, e.g. Battery"
},
"view": {
"enum": [
"full",
"compact"
],
"type": "string",
"description": "compact = part number, type, confidence, lpf_url, constraints, source only"
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"model": {
"type": "string",
"description": "e.g. lenovo-thinkpad-t490 or \"ThinkPad T490\""
},
"client": {
"type": "string",
"description": "Optional: your agent or app name (letters and digits), used only for anonymous usage counts."
},
"cursor": {
"type": "string"
}
}
}{
"type": "object",
"anyOf": [
{
"required": [
"slug",
"total_parts",
"parts"
]
},
{
"required": [
"status",
"candidates"
]
}
],
"properties": {
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"note": {
"type": "string"
},
"slug": {
"type": "string"
},
"view": {
"type": "string"
},
"limit": {
"type": "integer"
},
"parts": {
"type": "array",
"items": {
"type": "object",
"required": [
"part_number"
],
"properties": {
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"type": {
"type": "string"
},
"brand": {
"type": [
"string",
"null"
]
},
"notes": {
"type": [
"string",
"null"
]
},
"api_url": {
"type": "string"
},
"lpf_url": {
"type": "string"
},
"fit_type": {
"type": [
"string",
"null"
]
},
"buy_links": {
"type": "array",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string"
},
"kind": {
"type": "string"
},
"label": {
"type": "string"
},
"merchant": {
"type": "string"
},
"affiliate": {
"type": "boolean"
}
}
}
},
"confidence": {
"enum": [
"oem_manual",
"retailer",
"unverified"
],
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"constraints": {
"type": [
"string",
"null"
]
},
"part_number": {
"type": "string"
},
"verified_date": {
"type": [
"string",
"null"
]
},
"confidence_note": {
"type": "string"
},
"verification_basis": {
"type": [
"string",
"null"
]
}
}
}
},
"query": {
"type": "string"
},
"cursor": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"ambiguous"
],
"type": "string"
},
"api_url": {
"type": "string"
},
"license": {
"type": "string"
},
"message": {
"type": "string"
},
"aue_date": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"fit_count": {
"type": "integer"
},
"terms_url": {
"type": "string"
},
"board_name": {
"type": [
"string",
"null"
]
},
"candidates": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"name"
],
"properties": {
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"api_url": {
"type": "string"
},
"manufacturer": {
"type": "string"
}
}
}
},
"fit_status": {
"enum": [
"no_documented_fit"
],
"type": "string",
"description": "Present when there is no fit or no result: LPF has no OEM document for it. Never means incompatible."
},
"source_url": {
"type": [
"string",
"null"
]
},
"attribution": {
"type": "string"
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"total_parts": {
"type": "integer"
},
"type_filter": {
"type": "string"
},
"absence_note": {
"type": "string"
},
"manufacturer": {
"type": "string"
},
"release_year": {
"type": [
"integer",
"null"
]
},
"data_revision": {
"type": "string"
},
"panel_options": {
"type": [
"object",
"null"
]
},
"verified_date": {
"type": [
"string",
"null"
]
},
"candidate_count": {
"type": "integer"
},
"clarifying_question": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false
}get_part_fits — Get models a part fits
Look up an OEM part number and list every laptop model it is documented to fit, with the official source URL for each fit. For Screen parts each fit includes panel_options (null, or an object when that model has more than one documented screen option). Each part has lpf_url (its LPF page) and buy_links; follow buy_links_hint. Each fit has confidence: oem_manual, retailer or unverified.
{
"type": "object",
"required": [
"part_number"
],
"properties": {
"client": {
"type": "string",
"description": "Optional: your agent or app name (letters and digits), used only for anonymous usage counts."
},
"part_number": {
"type": "string"
}
}
}{
"type": "object",
"anyOf": [
{
"required": [
"part_number",
"fits"
]
},
{
"required": [
"status",
"candidates"
]
}
],
"properties": {
"url": {
"type": "string"
},
"fits": {
"type": "array",
"items": {
"type": "object",
"required": [
"model",
"source_url"
],
"properties": {
"url": {
"type": "string"
},
"model": {
"type": "string"
},
"notes": {
"type": [
"string",
"null"
]
},
"confidence": {
"enum": [
"oem_manual",
"retailer",
"unverified"
],
"type": "string"
},
"model_name": {
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"constraints": {
"type": [
"string",
"null"
]
},
"panel_options": {
"type": [
"object",
"null"
]
},
"source_detail": {
"type": [
"string",
"null"
]
},
"verified_date": {
"type": [
"string",
"null"
]
},
"confidence_note": {
"type": "string"
},
"verification_basis": {
"type": [
"string",
"null"
]
}
}
}
},
"name": {
"type": "string"
},
"note": {
"type": "string"
},
"type": {
"type": "string"
},
"brand": {
"type": [
"string",
"null"
]
},
"match": {
"type": "string"
},
"query": {
"type": "string"
},
"specs": {
"type": [
"object",
"null"
]
},
"status": {
"enum": [
"ambiguous"
],
"type": "string"
},
"api_url": {
"type": "string"
},
"license": {
"type": "string"
},
"lpf_url": {
"type": "string"
},
"message": {
"type": "string"
},
"buy_links": {
"type": "array",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string"
},
"kind": {
"type": "string"
},
"label": {
"type": "string"
},
"merchant": {
"type": "string"
},
"affiliate": {
"type": "boolean"
}
}
}
},
"terms_url": {
"type": "string"
},
"candidates": {
"type": "array",
"items": {
"type": "object"
}
},
"fit_status": {
"enum": [
"no_documented_fit"
],
"type": "string",
"description": "Present when there is no fit or no result: LPF has no OEM document for it. Never means incompatible."
},
"source_url": {
"type": [
"string",
"null"
]
},
"superseded": {
"type": "object"
},
"attribution": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"part_number": {
"type": "string"
},
"absence_note": {
"type": "string"
},
"data_revision": {
"type": "string"
},
"verified_date": {
"type": [
"string",
"null"
]
},
"normalized_from": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false
}find_repair_guides — Find repair guides
Find step-by-step replacement guides (battery, SSD, RAM, keyboard, fan, speakers, RTC battery, WLAN, etc.) paraphrased from official service manuals. Filter by model (slug or name; ambiguous names return candidates) and/or component. Also lists topics that are not yet covered (no steps published). Guides are not bench-tested.
{
"type": "object",
"properties": {
"model": {
"type": "string",
"description": "e.g. hp-elitebook-840-g6 or \"HP EliteBook 840 G6\""
},
"query": {
"type": "string",
"description": "optional free-text filter"
},
"component": {
"type": "string",
"description": "e.g. battery, ssd, ram, keyboard, fan, speakers"
}
}
}{
"type": "object",
"anyOf": [
{
"required": [
"count",
"guides",
"not_covered"
]
},
{
"required": [
"status",
"candidates"
]
}
],
"properties": {
"note": {
"type": "string"
},
"count": {
"type": "integer"
},
"model": {
"type": "string"
},
"query": {
"type": "string"
},
"guides": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"title"
],
"properties": {
"url": {
"type": "string"
},
"slug": {
"type": "string"
},
"model": {
"type": "string"
},
"pages": {
"type": [
"string",
"null"
]
},
"title": {
"type": "string"
},
"api_url": {
"type": "string"
},
"component": {
"type": "string"
},
"model_name": {
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"bench_tested": {
"type": "boolean"
},
"manufacturer": {
"type": "string"
},
"source_title": {
"type": [
"string",
"null"
]
},
"service_classification": {
"type": [
"string",
"null"
]
}
}
}
},
"status": {
"enum": [
"ambiguous"
],
"type": "string"
},
"license": {
"type": "string"
},
"message": {
"type": "string"
},
"component": {
"type": "string"
},
"terms_url": {
"type": "string"
},
"candidates": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"name"
],
"properties": {
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"api_url": {
"type": "string"
},
"manufacturer": {
"type": "string"
}
}
}
},
"fit_status": {
"enum": [
"no_documented_fit"
],
"type": "string",
"description": "Present when there is no fit or no result: LPF has no OEM document for it. Never means incompatible."
},
"attribution": {
"type": "string"
},
"not_covered": {
"type": "array",
"items": {
"type": "object",
"required": [
"model",
"topic"
],
"properties": {
"model": {
"type": "string"
},
"topic": {
"type": "string"
},
"status": {
"type": "string"
},
"model_name": {
"type": "string"
}
}
}
},
"absence_note": {
"type": "string"
},
"data_revision": {
"type": "string"
},
"candidate_count": {
"type": "integer"
},
"clarifying_question": {
"type": "string"
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false
}get_repair_guide — Get a repair guide
Get one repair guide by slug (from find_repair_guides): full Markdown steps with page citations, the official manual URL, HP service classification and scope restrictions. Not bench-tested; follow the scope restrictions and the OEM manual.
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "e.g. hp-elitebook-840-g6-battery-replacement"
}
}
}{
"type": "object",
"required": [
"slug",
"title",
"markdown"
],
"properties": {
"url": {
"type": "string"
},
"slug": {
"type": "string"
},
"model": {
"type": "string"
},
"pages": {
"type": [
"string",
"null"
]
},
"title": {
"type": "string"
},
"api_url": {
"type": "string"
},
"license": {
"type": "string"
},
"markdown": {
"type": "string"
},
"component": {
"type": "string"
},
"terms_url": {
"type": "string"
},
"fit_status": {
"enum": [
"no_documented_fit"
],
"type": "string",
"description": "Present when there is no fit or no result: LPF has no OEM document for it. Never means incompatible."
},
"model_name": {
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"attribution": {
"type": "string"
},
"absence_note": {
"type": "string"
},
"bench_tested": {
"type": "boolean"
},
"manufacturer": {
"type": "string"
},
"source_title": {
"type": [
"string",
"null"
]
},
"data_revision": {
"type": "string"
},
"service_classification": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}{
"readOnlyHint": true,
"openWorldHint": false
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 801 ms
- 95th percentile latency
- 801 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 801 ms · metadata changed · 7 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http laptop-part-finder-mcp https://laptoppartfinder.com/mcpCodex
codex mcp add laptop-part-finder-mcp --url https://laptoppartfinder.com/mcpCursor
{
"mcpServers": {
"laptop-part-finder-mcp": {
"url": "https://laptoppartfinder.com/mcp"
}
}
}Cline
{
"mcpServers": {
"laptop-part-finder-mcp": {
"type": "streamableHttp",
"url": "https://laptoppartfinder.com/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"laptop-part-finder-mcp": {
"type": "http",
"url": "https://laptoppartfinder.com/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http laptop-part-finder-mcp https://laptoppartfinder.com/mcpClaude Desktop
{
"mcpServers": {
"laptop-part-finder-mcp": {
"url": "https://laptoppartfinder.com/mcp"
}
}
}Windsurf
{
"mcpServers": {
"laptop-part-finder-mcp": {
"serverUrl": "https://laptoppartfinder.com/mcp"
}
}
}Let your agent find its tools
Find servers like Laptop Part Finder MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other developer tools servers
Do you run Laptop Part Finder MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.