Laptop Part Finder

npx add-mcp 'https://laptoppartfinder.com/mcp'

Free, read-only access to every part number and fit, with sources.

Python note: the default urllib User-Agent (Python-urllib/3.x) gets HTTP 403 with error code: 1010 from Cloudflare before the request reaches LPF, and no site setting can change that for a Cloudflare Pages site. Send any descriptive User-Agent, for example my-app/1.0; the defaults of requests, httpx, aiohttp and curl are fine.

Limits: please keep to about 1 request per second. The soft cap that is enforced is per minute and per client: 300 requests/min on /api/* and 120/min on /mcp without a key (1500 and 600 with a key). Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset (best effort, per edge location), and HTTP 429 plus Retry-After if exceeded. A rare 503 is temporary, so retry it. For bulk use, download /api/v1/data.json once.

Laptop Part Finder is built to be read by software as well as people. Every lookup endpoint is free, read-only and needs no API key (an optional free key is available). The one exception is sending a correction, which only adds a note to a private review queue. Operated by The Maktecho Forge. Every fit includes the source_url it came from and a typed confidence (oem_manual, retailer or unverified). Current coverage: 4116 laptop models, 21395 OEM parts and 45233 documented part-to-model fits.

JSON API

• GET https://laptoppartfinder.com/api/coverage what LPF covers: brands, every model with its part types and fit counts, totals (/api/coverage)
• GET https://laptoppartfinder.com/api/states the state contract: every response carries outcome (found, no_documented_fit, needs_clarification, not_found); this lists every status value and what it means (/api/states)
• GET https://laptoppartfinder.com/api/models lists models (optional ?brand=Lenovo, ?category=business-laptop)
• GET https://laptoppartfinder.com/api/models/{slug} one model with all its parts and sources, e.g. /api/models/lenovo-thinkpad-t490
• GET https://laptoppartfinder.com/api/parts/{part_number} one part and every model it fits (part number or page slug), plus untagged buy_links (eBay/Amazon/Newegg searches, affiliate: false) and lpf_url for the labelled where-to-buy page
• GET https://laptoppartfinder.com/api/suggest?q=t49 type-ahead (~1 KB: up to 8 models and 6 part-number prefixes; use /api/search for full results)
• GET https://laptoppartfinder.com/api/guides lists repair guides (summaries and slugs; optional ?model=, ?component=, ?query=; MCP search_repair_guides; the old name find_repair_guides still works); GET https://laptoppartfinder.com/api/guides/{slug} (MCP get_repair_guide) returns one guide as Markdown with its source and page citations (not bench-tested)
• GET https://laptoppartfinder.com/api/search?q=t490 battery search models and parts (optional &type=Battery, &limit= default 20, max 50 per list; an empty result means no documented part, not that none exists)

Responses are JSON with open CORS and are cached for an hour. Full reference: /api/.

MCP server

AI assistants that support the Model Context Protocol can connect to https://laptoppartfinder.com/mcp (Streamable HTTP, no auth required). Tools: resolve_request, search_parts, list_models, get_model_parts, get_part, get_part_fits, check_part_fits, search_repair_guides, get_repair_guide, get_coverage, submit_correction. Every lookup tool is read-only and returns source URLs; submit_correction looks nothing up and only adds a note to a private review queue (Send a correction).

{ "mcpServers": { "laptop-part-finder": { "url": "https://laptoppartfinder.com/mcp" } } }

Step-by-step setup for Claude Desktop, Claude Code, Cursor, VS Code Copilot and any Streamable HTTP client, plus a REST fallback and the confidence types: Use with AI agents. VS Code uses {"servers":{"laptop-part-finder":{"type":"http","url":"https://laptoppartfinder.com/mcp"}}}.

Plain-text summaries

• /llms.txt (site summary for language models)
• /agents/ (MCP client setup)

Usage notes

• Compatibility comes from OEM documentation and is not bench-tested. Check each fit's constraints (for example touch vs non-touch screens).
• Models with more than one documented screen part carry panel_options (count, part_numbers, differs_by, connector_documented, advice). Panels for the same model can use different connectors or resolutions; have the user check their current panel's part number or connector before ordering.
• We publish no prices, stock or ratings.
• Please keep request rates modest; heavy automated use may be throttled.

Where-to-buy links (buy_links)

Current policy: API and MCP responses carry no affiliate-tagged links. Each part has lpf_url (its LPF page, with the labelled where-to-buy links) and untagged retailer searches in buy_links (affiliate: false).

Every part in /api/parts/{part_number}, /api/models/{slug}, /api/search and the MCP tools (get_part_fits, get_model_parts, search_parts) carries buy_links: [{merchant, label, url, affiliate, kind}]: plain, untagged eBay and Amazon searches for the OEM part number (Newegg for some types), affiliate: false. They are not a fit guarantee. A buy_links_hint field tells agents to send the user to lpf_url or show these links when the user wants to buy. The human website may use affiliate links; see /privacy/ and /terms/.

Optional free API key

You do not need a key. The API and MCP server work without one, exactly as described above, and that is not changing. A key is an optional extra for people who want a more stable limit or want to be identifiable to us.

• What it is: a read-only key (scope read) that can be revoked at any time. It gives you your own, higher soft rate limit (about 5 times the keyless one). It unlocks no extra data, and no key is needed to send a correction.
• Cost and sign-up: free. No account, no payment, no outside sign-up.
• How to get one: email [email protected] with a short client name (for example, the name of your agent or app). The Maktecho Forge, which runs Laptop Part Finder, issues keys by hand and replies with a key of the form lpf_…. Please allow some time for a reply.
• How to use it: send Authorization: Bearer lpf_… (or X-API-Key: lpf_…) to https://laptoppartfinder.com/mcp or https://laptoppartfinder.com/api/…. In an MCP client config, add a header, for example { "mcpServers": { "laptop-part-finder": { "url": "https://laptoppartfinder.com/mcp", "headers": { "Authorization": "Bearer lpf_…" } } } }. Keep the key out of public repos.
• Revocation: we can revoke a key at any time, and you can ask us to. A revoked or invalid key is answered with HTTP 401 and a WWW-Authenticate header; remove the header to go back to keyless use.
• Privacy: we keep the email you wrote from, your client name and a one-way hash of the key. See the privacy policy.

Operated by The Maktecho Forge. Release notes and the last-updated date: changelog.

Data license

Free to use with attribution: credit "Laptop Part Finder" and link to https://laptoppartfinder.com (or the page you used). Please do not republish or mirror the dataset in bulk without permission. Agents and apps are welcome to look things up live through the API and MCP. Every response carries a license field. Full terms: /terms/#data-license.