PartsPlan

Comparison criteria and datasheet locations

compare_points

Read-onlyIdempotent

Intended for checking whether caller-selected candidate parts could replace a source part: it lists what to compare and the available archived datasheet locations for each point (search_parts finds candidates). Returns adjustable default comparison criteria, importance weights, and archived datasheet locations for a supplied source part and up to three caller-selected candidates. Weights describe the requested rubric; the result contains no component values, candidate scores, rankings, or compatibility verdicts. The rubric separates hard lines, weighted items summing to 100 and unweighted checks; scenario, purpose, exclusions, relaxed hard lines and weights adjust it, and result.applied records each adjustment. Item ids in the result are the ids these inputs accept.

Input Schema

Name	Required	Description
`device`	No	Device rubric; general (default) has only the common items and checks. relay = electromechanical relay (coil and contacts); photorelay = MOSFET-output optical relay (PhotoMOS, MOS FET relay, photorelay); diode = rectifier, Schottky or switching diode (not Zener, TVS or ESD protection); diode_zener = Zener or voltage-regulator diode; diode_tvs = TVS diode or ESD protection array; bjt = bipolar junction transistor (NPN, PNP or Darlington); led = indicator or lighting LED; optocoupler_transistor = optocoupler with phototransistor or photo-Darlington output; resistor_chip = fixed chip resistor (thick or thin film, current sense); capacitor_mlcc = multilayer ceramic capacitor; capacitor_electrolytic = aluminum electrolytic capacitor (liquid, polymer or hybrid electrolyte); capacitor_tantalum = tantalum capacitor (MnO2, polymer or wet); inductor_power = power inductor (not common-mode choke or coupled inductor); fuse = non-resettable overcurrent fuse; fuse_ptc = resettable polymer PTC (PPTC) fuse; varistor = metal-oxide or multilayer varistor; crystal = quartz crystal unit or ceramic resonator (passive, needs an oscillator circuit); oscillator = packaged clock oscillator (XO, TCXO, VCXO, OCXO or MEMS) with a powered output; logic = logic gate, buffer, inverter, flip-flop or latch IC (not analog switch or level translator); comparator = analog voltage comparator; memory_eeprom = serial EEPROM (I2C, SPI or Microwire); memory_nor = serial NOR flash (SPI, dual, quad or octal); memory_sram = asynchronous or synchronous SRAM; memory_dram = DRAM (SDRAM, DDR1 to DDR5, LPDDR or GDDR); interface_rs485 = RS-485 or RS-422 transceiver; mcu = microcontroller; audio_power_amp = audio power amplifier for speakers or headphones (class AB or D); battery_protector = Li-ion or Li-polymer battery protection IC; battery_charger = battery charger IC (linear or switching); adc = analog-to-digital converter; motor_bridge = motor driver IC with integrated output stage (brushed DC, stepper or brushless); isolated_gate_driver = isolated gate driver IC (optical, capacitive or magnetic isolation); dc_dc_module = DC/DC converter module (isolated or non-isolated, complete power stage); optocoupler_logic = optocoupler with logic or high-speed digital output; thyristor = SCR or TRIAC
`source`	Yes	The part being replaced or compared
`purpose`	No	Weight multipliers for that design focus; balanced (default) applies none
`weights`	No	Raw weights 0-100 by weighted item id, applied before the purpose multiplier and the normalization to 100
`scenario`	No	drop_in (default) keeps the existing board, so pin, land, outline and drive-interface items are hard lines; in redesign those become checks unless listed in relax_items
`candidates`	Yes	One to three parts chosen by the caller; kept in the given order as c1, c2, c3
`relax_items`	No	Hard-line item ids (or ids moved to checks by the redesign scenario) that become weighted items with their default weight
`exclude_items`	No	Item ids removed from the rubric; exclusion takes precedence over relax_items and weights
`exclude_groups`	No	Groups removed from the rubric, including their hard lines and checks

Output Schema

Name	Required	Description	Default
`note`	No
`reason`	No
`result`	No
`status`	Yes
`message`	No
`retryable`	No
`doc_sha256`	No
`request_id`	No
`valid_items`	No
`invalid_items`	No
`retry_after_ms`	No
`withdrawn_note`	No
`withdrawn_documents_omitted`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 26, 2026

changedInput schema / properties / device / description

Previous value: -"Device rubric; general (default) has only the common items and checks. relay = electromechanical relay (coil and contacts); photorelay = MOSFET-output optical relay (PhotoMOS, MOS FET relay, photorelay); diode = rectifier, Schottky or switching diode (not Zener, TVS or ESD protection); diode_zener = Zener or voltage-regulator diode; diode_tvs = TVS diode or ESD protection array; bjt = bipolar junction transistor (NPN, PNP or Darlington); led = indicator or lighting LED; optocoupler_transistor = optocoupler with phototransistor or photo-Darlington output; resistor_chip = fixed chip resistor (thick or thin film, current sense); capacitor_mlcc = multilayer ceramic capacitor; capacitor_electrolytic = aluminum electrolytic capacitor (liquid, polymer or hybrid electrolyte); capacitor_tantalum = tantalum capacitor (MnO2, polymer or wet); inductor_power = power inductor (not common-mode choke or coupled inductor); fuse = non-resettable overcurrent fuse; fuse_ptc = resettable polymer PTC (PPTC) fuse; varistor = metal-oxide or multilayer varistor; crystal = quartz crystal unit or ceramic resonator (passive, needs an oscillator circuit); oscillator = packaged clock oscillator (XO, TCXO, VCXO, OCXO or MEMS) with a powered output; logic = logic gate, buffer, inverter, flip-flop or latch IC (not analog switch or level translator); comparator = analog voltage comparator; memory_eeprom = serial EEPROM (I2C, SPI or Microwire); memory_nor = serial NOR flash (SPI, dual, quad or octal); memory_sram = asynchronous or synchronous SRAM; interface_rs485 = RS-485 or RS-422 transceiver; mcu = microcontroller; audio_power_amp = audio power amplifier for speakers or headphones (class AB or D); battery_protector = Li-ion or Li-polymer battery protection IC; battery_charger = battery charger IC (linear or switching); adc = analog-to-digital converter; motor_bridge = motor driver IC with integrated output stage (brushed DC, stepper or brushless); isolated_gate_driver = isolated gate driver IC (optical, capacitive or magnetic isolation); dc_dc_module = DC/DC converter module (isolated or non-isolated, complete power stage); optocoupler_logic = optocoupler with logic or high-speed digital output; thyristor = SCR or TRIAC"New value: +"Device rubric; general (default) has only the common items and checks. relay = electromechanical relay (coil and contacts); photorelay = MOSFET-output optical relay (PhotoMOS, MOS FET relay, photorelay); diode = rectifier, Schottky or switching diode (not Zener, TVS or ESD protection); diode_zener = Zener or voltage-regulator diode; diode_tvs = TVS diode or ESD protection array; bjt = bipolar junction transistor (NPN, PNP or Darlington); led = indicator or lighting LED; optocoupler_transistor = optocoupler with phototransistor or photo-Darlington output; resistor_chip = fixed chip resistor (thick or thin film, current sense); capacitor_mlcc = multilayer ceramic capacitor; capacitor_electrolytic = aluminum electrolytic capacitor (liquid, polymer or hybrid electrolyte); capacitor_tantalum = tantalum capacitor (MnO2, polymer or wet); inductor_power = power inductor (not common-mode choke or coupled inductor); fuse = non-resettable overcurrent fuse; fuse_ptc = resettable polymer PTC (PPTC) fuse; varistor = metal-oxide or multilayer varistor; crystal = quartz crystal unit or ceramic resonator (passive, needs an oscillator circuit); oscillator = packaged clock oscillator (XO, TCXO, VCXO, OCXO or MEMS) with a powered output; logic = logic gate, buffer, inverter, flip-flop or latch IC (not analog switch or level translator); comparator = analog voltage comparator; memory_eeprom = serial EEPROM (I2C, SPI or Microwire); memory_nor = serial NOR flash (SPI, dual, quad or octal); memory_sram = asynchronous or synchronous SRAM; memory_dram = DRAM (SDRAM, DDR1 to DDR5, LPDDR or GDDR); interface_rs485 = RS-485 or RS-422 transceiver; mcu = microcontroller; audio_power_amp = audio power amplifier for speakers or headphones (class AB or D); battery_protector = Li-ion or Li-polymer battery protection IC; battery_charger = battery charger IC (linear or switching); adc = analog-to-digital converter; motor_bridge = motor driver IC with integrated output stage (brushed DC, stepper or brushless); isolated_gate_driver = isolated gate driver IC (optical, capacitive or magnetic isolation); dc_dc_module = DC/DC converter module (isolated or non-isolated, complete power stage); optocoupler_logic = optocoupler with logic or high-speed digital output; thyristor = SCR or TRIAC"