ai.partsgraph/catalog

Official11 tools

by partsgraph

Search real parts with datasheet-provenance specs, check compatibility and compose priced BOMs.

ai.partsgraph/catalog MCP Server

The ai.partsgraph/catalog MCP server provides tools to search real parts using datasheet-provenance specifications, verify compatibility, and compose priced bills of materials (BOMs). The catalog is exposed via 11 tools, supporting developer workflows that need part sourcing, cross-checking, and BOM creation.

🛠️ Key Features

Search real parts with datasheet-provenance specs
Check compatibility
Compose priced BOMs

🚀 Use Cases

Locate parts with provenance-backed specifications
Validate component compatibility before ordering
Generate priced BOMs for assemblies

⚡ Developer Benefits

Structured access to part search, compatibility checking, and BOM pricing via 11 tools
Reduces manual steps when assembling and pricing component lists

⚠️ Limitations

Tool coverage is limited to the capabilities described: search, compatibility checks, and priced BOM composition

Captured live from the server via tools/list.

search_parts

Full-text search over the demo catalogue's provenance-backed part records. Filter by category, build or role. Every attribute returned was corroborated against the manufacturer datasheet or vendor page.

Parameters6

query	string	required	What you are looking for
category	string	optional
build	string	optional
role	string	optional
limit	integer	optional
project_context	string	optional	One sentence on what you are building. Results are ranked for your project. Queries and this context are logged anonymously to power the public demo dashboard.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What you are looking for"
    },
    "category": {
      "type": "string"
    },
    "build": {
      "type": "string"
    },
    "role": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "project_context": {
      "description": "One sentence on what you are building. Results are ranked for your project. Queries and this context are logged anonymously to power the public demo dashboard.",
      "type": "string",
      "maxLength": 500
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_part

The complete canonical record for one part: every attribute with its provenance (source, page, verbatim quote, file hash), vendors with dated indicative prices, and datasheet links.

Parameters2

id	string	required	Part id, e.g. pololu-drv8833-carrier
project_context	string	optional	One sentence on what you are building. Results are ranked for your project. Queries and this context are logged anonymously to power the public demo dashboard.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Part id, e.g. pololu-drv8833-carrier"
    },
    "project_context": {
      "description": "One sentence on what you are building. Results are ranked for your project. Queries and this context are logged anonymously to power the public demo dashboard.",
      "type": "string",
      "maxLength": 500
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

list_categories

Every category in the catalogue with its part count.

Parameters1

project_context

string

optional

One sentence on what you are building. Results are ranked for your project. Queries and this context are logged anonymously to power the public demo dashboard.

Raw schema

{
  "type": "object",
  "properties": {
    "project_context": {
      "description": "One sentence on what you are building. Results are ranked for your project. Queries and this context are logged anonymously to power the public demo dashboard.",
      "type": "string",
      "maxLength": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

list_builds

The catalogue's reference builds (robot, weather station, plant waterer) with their roles and candidate parts — the starting point for build_bom.

Parameters1

project_context

string

optional

One sentence on what you are building. Results are ranked for your project. Queries and this context are logged anonymously to power the public demo dashboard.

Raw schema

{
  "type": "object",
  "properties": {
    "project_context": {
      "description": "One sentence on what you are building. Results are ranked for your project. Queries and this context are logged anonymously to power the public demo dashboard.",
      "type": "string",
      "maxLength": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

check_compatibility

Evaluates a part set against the build's engineering constraints — supply windows, stall vs peak current, shaft/wheel fit, interfaces, solar chain — with a reasoned verdict per check. Every number cited is a corroborated attribute.

Parameters3

part_ids	array	required
build_id	string	optional	Defaults to the build these parts overlap most
project_context	string	optional	One sentence on what you are building. Results are ranked for your project. Queries and this context are logged anonymously to power the public demo dashboard.

Raw schema

{
  "type": "object",
  "properties": {
    "part_ids": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "build_id": {
      "description": "Defaults to the build these parts overlap most",
      "type": "string"
    },
    "project_context": {
      "description": "One sentence on what you are building. Results are ranked for your project. Queries and this context are logged anonymously to power the public demo dashboard.",
      "type": "string",
      "maxLength": 500
    }
  },
  "required": [
    "part_ids"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

compare_parts

Aligned attribute-by-attribute comparison of two catalogue parts. Absence means the sources did not state a value — never that the part lacks the property.

Parameters3

a	string	required	First part id
b	string	required	Second part id
project_context	string	optional	One sentence on what you are building. Results are ranked for your project. Queries and this context are logged anonymously to power the public demo dashboard.

Raw schema

{
  "type": "object",
  "properties": {
    "a": {
      "type": "string",
      "description": "First part id"
    },
    "b": {
      "type": "string",
      "description": "Second part id"
    },
    "project_context": {
      "description": "One sentence on what you are building. Results are ranked for your project. Queries and this context are logged anonymously to power the public demo dashboard.",
      "type": "string",
      "maxLength": 500
    }
  },
  "required": [
    "a",
    "b"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_provenance

The receipt behind a stated value: the verbatim source quote, the page, the extraction method, and the sha-256 of the exact file it was read from — plus a ready-made citation line. Omit code for every attribute's receipt.

Parameters3

id	string	required	Part id
code	string	optional	Attribute code from get_part; omit for all
project_context	string	optional	One sentence on what you are building. Results are ranked for your project. Queries and this context are logged anonymously to power the public demo dashboard.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Part id"
    },
    "code": {
      "description": "Attribute code from get_part; omit for all",
      "type": "string"
    },
    "project_context": {
      "description": "One sentence on what you are building. Results are ranked for your project. Queries and this context are logged anonymously to power the public demo dashboard.",
      "type": "string",
      "maxLength": 500
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

build_bom

Composes a complete BOM for a reference build — quantities, dated indicative prices, per-line rationale, a compatibility verdict for the chosen set, and a CSV export. Override any role with choices.

Parameters3

build_id	string	required	2wd-robot, weather-station or plant-waterer
choices	object	optional	role → part id overrides
project_context	string	optional	One sentence on what you are building. Results are ranked for your project. Queries and this context are logged anonymously to power the public demo dashboard.

Raw schema

{
  "type": "object",
  "properties": {
    "build_id": {
      "type": "string",
      "description": "2wd-robot, weather-station or plant-waterer"
    },
    "choices": {
      "description": "role → part id overrides",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "project_context": {
      "description": "One sentence on what you are building. Results are ranked for your project. Queries and this context are logged anonymously to power the public demo dashboard.",
      "type": "string",
      "maxLength": 500
    }
  },
  "required": [
    "build_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

search

Search the Partsgraph demo catalogue. Returns result ids for fetch. Alias of search_parts shaped to the search/fetch connector contract.

Parameters1

query

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

fetch

Fetch the full provenance-backed record for a search result id as a citable document. Alias of get_part shaped to the search/fetch connector contract.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

view_bom

Composes the BOM for a reference build and renders it as an interactive view in clients that support MCP Apps. Same data as build_bom.

Parameters2

build_id	string	required	2wd-robot, weather-station or plant-waterer
choices	object	optional

Raw schema

{
  "type": "object",
  "properties": {
    "build_id": {
      "type": "string",
      "description": "2wd-robot, weather-station or plant-waterer"
    },
    "choices": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    }
  },
  "required": [
    "build_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Install

Tools (11)

search_partsget_partlist_categorieslist_buildscheck_compatibilitycompare_partsget_provenancebuild_bom

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://partsgraph.ai/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "catalog": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://partsgraph.ai/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

ai.partsgraph/catalog MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search_parts

get_part

list_categories

list_builds

check_compatibility

compare_parts

get_provenance

build_bom

search

fetch

view_bom

Install

Remote endpoint

Related servers