sheetsdata-mcp

Analyze an image from a component's datasheet using vision AI. Use this when read_datasheet returns a section containing images and you need to extract data from a graph, package drawing, pin diagram, or circuit schematic. Pass the image_key from the read_datasheet response (the storage path in the image URL). Optionally pass a specific question to focus the analysis.

IMPORTANT: For precise numeric values (electrical specs, max ratings), prefer read_datasheet text tables first — they are more reliable than vision-extracted graph data. Use analyze_image for visual information not available in text: package dimensions from drawings, pin assignments from diagrams, graph trends, and approximate values from characteristic curves.

Examples:

• analyze_image(part_number='IRFZ44N', image_key='images/abc123.png') → classifies and describes the image

• analyze_image(part_number='IRFZ44N', image_key='images/abc123.png', question='What is the drain current at Vgs=5V?')

Validate whether a component will work within your operating conditions. Checks the datasheet's absolute maximum ratings and recommended operating conditions against your design parameters. Returns PASS/FAIL/WARNING per parameter with margins. Example: check_design_fit('TPS54302', input_voltage=24, output_current=2.5, ambient_temp=70)

Check the extraction status of one or more parts. Returns per-part status: 'ready' (datasheet extracted), 'extracting' (in progress), 'pending' (queued), 'failed' (extraction failed), or 'not_extracted' (unknown part). Includes current extraction step, elapsed time, and document ID for tracking. Free — use this to poll progress after prefetch_datasheets or read_datasheet.

Compare 2-5 electronic components side by side. Returns merged details from all providers and cached datasheet summaries for each part, making it easy to compare specs, pricing, and availability. Includes datasheet_status per part. Example: compare_parts(['TPS54302', 'LM2596', 'MP2359'])

Find alternative/substitute components for a given part number. Searches across providers for parts with similar specs, same package, or compatible pinout. Useful when a part is out of stock, too expensive, or you need a second source.

Example: find_alternative('TPS54302', constraints='same_package,in_stock')

Get full details for a specific electronic component by manufacturer part number (MPN) or LCSC number. Returns specs, pricing, and stock from all configured providers, plus the cached datasheet summary if available. Includes datasheet_status ('ready', 'extracting', or 'not_extracted') and available_sections when ready. Set prefetch_datasheet=true to trigger background extraction — no extra charge. Use after search_parts to drill into a specific result.

The part_number must be a specific manufacturer part number (e.g. 'TPS54302DDCR', 'STM32F446RCT6') or LCSC number (e.g. 'C2837938'). Do NOT pass bare component values ('100nF', '10K'), descriptions ('buck converter'), or reference designators ('R1', 'U3').

Trigger background datasheet extraction for multiple parts at once (up to 20). Non-blocking — returns immediately with the status of each part: 'ready' (already extracted), 'queued' (extraction started), or 'error'. Use this to warm up datasheets for a BOM before calling read_datasheet. Example: prefetch_datasheets(['TPS54302', 'ADS1115', 'LP5907'])

IMPORTANT — only pass specific manufacturer part numbers (MPNs). Before calling, verify each part number:

• Must be a real MPN like 'STM32F446RCT6', 'TPS54302DDCR', 'C100nF' — NOT a description or value.

• Do NOT pass bare values like '100nF', '10K', '4.7uF', '300ohm' — these are component values, not part numbers.

• Do NOT pass generic descriptions like 'LED red', 'capacitor 100nF', 'resistor 0603'.

• Do NOT pass BOM reference designators like 'R1', 'C5', 'U3'.

• If the BOM only has values/descriptions without MPNs, use search_parts first to find the actual MPN.

• Passives from BOMs often lack MPNs — skip them rather than prefetching a bare value.

Read from a component's datasheet. Two modes:

Section mode (default): Returns a named section. Start with section='summary' to get an overview and a list of available_sections. Then request specific sections by name. Section names are dynamic — any heading in the actual datasheet works (e.g. 'register_map', 'i2c_interface', 'power_management'). If a section name isn't found, automatically falls back to search mode.

Search mode: Semantic search within the part's datasheet. Best for targeted questions (register bit fields, I2C config, specific specs). Use when you need to find specific information rather than a whole section.

First call for a new part triggers extraction (30s-2min). Subsequent calls are cached.

The part_number must be a specific manufacturer part number (e.g. 'TPS54302', 'STM32F446RCT6') or LCSC number (e.g. 'C2837938'). Do NOT pass bare component values ('100nF', '10K'), descriptions, or reference designators.

Semantic search across all extracted datasheets. Finds components matching natural language queries about specifications, features, or capabilities. Best for broad spec-based discovery across all parts (e.g. 'low-noise LDO with PSRR above 70dB'). Only searches datasheets that have been previously extracted — not all parts that exist. For finding specific parts by number, use search_parts instead.

Search for electronic components by part number, description, or keyword. Start here — this is the best entry point for finding components. Queries all configured providers in parallel. Results are merged by MPN with indicative pricing and stock from each source. Each result includes datasheet_status ('ready', 'extracting', or 'not_extracted') so you know which parts have datasheets available for read_datasheet. Best with specific part numbers or keywords (e.g. 'STM32F103', 'buck converter 3A'). For spec-based discovery in natural language, use search_datasheets instead.