SheetsData
Server Details
Electronic component datasheets for AI agents: pinouts, specs, package info and design checks.
- Status
- Healthy
- Uptime
- 100.0% over 61 days
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- octoco-ltd/sheetsdata-mcp
- GitHub Stars
- 13
- Server Listing
- SheetsData MCP
TDQS
Scored across 14 tools
Most tools have clearly distinct purposes (read_datasheet vs analyze_image vs check_design_fit vs search_datasheets are well delineated). However search_parts and find_parts both perform component discovery by specs/keywords, and find_alternative adds a third discovery-adjacent surface, creating some risk of misselection despite the descriptions attempting to separate them.
All 14 tools use consistent snake_case verb_noun naming (search_parts, find_parts, read_datasheet, check_design_fit, prefetch_datasheets, compare_parts, request_datasheet_upload, etc.). check_bom and analyze_image fit the same pattern. Highly predictable.
14 tools is well within the ideal range and each earns its place: discovery, comparison, datasheet lifecycle (prefetch/read/status), vision, design validation, BOM check, and the upload flow. No filler tools apparent.
The surface covers the full parts/datasheet lifecycle: discover, drill in, compare, find alternatives, extract, read, search, analyze images, validate design fit, and upload missing datasheets. Minor gaps exist (no explicit BOM export or parameter-listing tool), but core workflows are covered end-to-end with no dead ends.
Available Tools
14 toolsanalyze_imageAnalyze Datasheet ImageRead-onlyIdempotentInspect
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?')
| Name | Required | Description | Default |
|---|---|---|---|
| question | No | Optional specific question about the image (e.g. 'What are the package dimensions?') | |
| image_key | Yes | Image storage path from read_datasheet output (e.g. 'images/abc123.png') | |
| part_number | Yes | MPN of the component |
check_bomCheck BOMARead-onlyIdempotentInspect
Check up to 20 BOM lines for lifecycle, stock against quantity, observed single-distributor sourcing, datasheet status and stale/missing prices. Accepts MPNs or LCSC numbers; duplicate MPN quantities are aggregated. Uses exact identities, catalogue snapshots and available distributor details. Unknown remains unknown; single_source does not prove only one supplier exists. Compact columns/rows by default; verbose returns objects. No extraction.
| Name | Required | Description | Default |
|---|---|---|---|
| lines | Yes | ||
| verbose | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnly/idempotent/non-destructive/open-world, so the safety profile is covered. The description adds genuinely useful beyond-schema context: interpretation caveats ('Unknown remains unknown; single_source does not prove only one supplier exists'), the default compact vs verbose output shape, and the limitation 'No extraction.'
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Dense but efficient: each clause adds a distinct fact (scope cap, input formats, aggregation rule, caveats, output mode, limitation), and the core capability is front-loaded. Slightly telegraphic sentence fragments cost a little readability, but nothing is wasted.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no output schema, the description partially compensates by describing compact vs verbose return shapes, and its caveats preempt likely misinterpretation of results. Missing pieces are minor — no mention of error behavior or what happens when a line's identity cannot be resolved beyond the 'unknown remains unknown' note.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must carry the load and largely does: it clarifies that the mpn field accepts MPNs or LCSC numbers, that duplicate MPNs are quantity-aggregated, and that the 20-line cap applies. It also explains that verbose switches from compact columns/rows to objects, which the bare boolean default does not convey. Minor gap: nothing about the qty semantic beyond 'stock against quantity.'
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource with unusual precision: it enumerates exactly what is checked (lifecycle, stock against quantity, single-distributor sourcing, datasheet status, stale/missing prices) and caps scope at 20 BOM lines. It does not explicitly name or distinguish itself from siblings such as check_design_fit or find_alternative, but the batch-BOM framing is unambiguous.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Usage context is implied by the input contract — 'Accepts MPNs or LCSC numbers; duplicate MPN quantities are aggregated' tells the agent it is a bulk BOM-validation tool. However, there is no explicit when-to-use/when-not guidance and no routing to alternatives (e.g., find_alternative or get_part_details for single-part lookups), so the agent must infer the boundary.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
check_design_fitCheck Design FitRead-onlyInspect
Validate whether a component will work within your operating conditions. Compares your design parameters against the datasheet's absolute maximum ratings and recommended operating conditions. Returns PASS/FAIL/WARNING per parameter with margin percentages.
Parameter mapping by component type:
Buck/boost converters: input_voltage, output_voltage, output_current, ambient_temp, efficiency
MOSFETs: supply_voltage=VDS, output_current=ID (drain current), ambient_temp, power_dissipation
LDOs: input_voltage, output_voltage, output_current, ambient_temp
Logic ICs: supply_voltage=VCC, ambient_temp
Result semantics (per-parameter 'result' field):
PASS: comfortable margin. For a recommended-operating RANGE, any value inside the range (including the exact edges) is PASS. For an absolute-MAX rating, PASS means more than 10% below the limit.
WARNING: for absolute-max ratings only, the user value is within 10% of the limit (but not over) — part will work but with thin margin for part-to-part variation, temperature drift, and transients. Consider derating.
FAIL: user value is outside the allowed range / exceeds the limit — part is out of spec and will be stressed or damaged.
INSUFFICIENT_DATA: the check could not be completed safely — most commonly an ambient_temp input that could not be translated to a junction-temperature check (see the temperature note below). INSUFFICIENT_DATA never counts as a PASS: it pulls the overall verdict down to at-least-WARNING. Each check also reports 'limit_type' (max / min / range / fixed) so you can see whether it was judged against an operating range, an absolute-max rating, or a fixed-output setpoint. Checks read from the datasheet text (source='llm') also carry 'source_quote', the datasheet row the limit was taken from. A condition with no limit anywhere is listed in 'unmatched' and keeps the overall verdict at WARNING; a clean PASS means every condition was checked.
Temperature:
ambient_temp is never silently compared with a junction-temperature limit. When the part's own dissipation is known, the tool estimates Tj = Ta + Pd × RθJA (RθJA from the datasheet's thermal table, the highest value it gives) and judges Tj against the junction limits, reported as 'temperature (junction est.)' with the arithmetic in the note. Pd by part type: LDO (Vin - Vout) × Iout; switching converter Vout × Iout × (1/η - 1), which needs efficiency (read it from the datasheet's efficiency curve, e.g. with analyze_image); anything else, pass power_dissipation (for a MOSFET, ID² × RDS(on) at your gate drive). Without these the check is INSUFFICIENT_DATA and its note says what to pass.
Current ratings are read at ambient_temp: a MOSFET's 25 °C drain current is derated towards its maximum junction temperature, or the datasheet's own row for a hotter temperature is used.
'temperature_basis' (junction / ambient / unknown) tells you which basis was used.
Behavior:
Two-tier validation. For parameters in our structured database (Vin, Iout, operating temp, etc.), returns instantly and free of LLM cost. For parameters only found in the datasheet text, falls back to an LLM read of the absolute-max and recommended-operating-conditions sections. The 'validation_method' field in the response tells you which path was used.
If the part hasn't been extracted yet and the LLM fallback is needed, this call triggers extraction (usually 1-3 minutes). Returns status='extracting' if so — poll check_extraction_status and retry.
When NOT to use:
You need transient or full thermal analysis — the junction estimate is a steady-state screen.
You need SOA (safe-operating-area) curve checks for MOSFETs — use analyze_image on the SOA graph.
You're checking a passive or mechanical part with no abs-max table — there's nothing for this tool to compare against.
Example: check_design_fit('TPS54302', input_voltage=24, output_voltage=5, output_current=2.5, ambient_temp=70, efficiency=0.92)
| Name | Required | Description | Default |
|---|---|---|---|
| efficiency | No | Converter efficiency at this operating point, as a fraction (0.92) or a percentage (92). Lets the tool estimate a switching converter's junction temperature. | |
| part_number | Yes | Specific manufacturer part number to validate. Not a value or description. | |
| ambient_temp | No | Ambient temperature TA (°C). | |
| input_voltage | No | Input voltage / VIN (V). For converters. | |
| output_current | No | Output current / IOUT (A). For MOSFETs, this is drain current ID. | |
| output_voltage | No | Output voltage / VOUT (V). For converters/LDOs. | |
| supply_voltage | No | Supply voltage / VCC / VDD (V). For MOSFETs, this is VDS (drain-source voltage). NOT used for power dissipation — compared against VDS(max) only. | |
| power_dissipation | No | The part's own power dissipation (W), if you have worked it out (e.g. ID² × RDS(on) for a MOSFET). Used for the junction-temperature estimate. | |
| switching_frequency | No | Switching frequency FSW (kHz). For converters. |
check_extraction_statusCheck Datasheet StatusRead-onlyIdempotentInspect
Check the extraction status of one or more parts. Free. Each entry includes the current extraction step, elapsed seconds, and document ID.
Use after prefetch_datasheets or after read_datasheet triggers a new extraction.
Recommended polling cadence: every 10-15 seconds. A datasheet nobody has read before usually takes 1-3 minutes (a large one 5 or more), so faster polling wastes calls. Keep polling while the status is 'resolving', 'queued', 'pending' or 'extracting'; stop once it is 'ready', 'failed', 'no_source' or 'unsupported'.
DATASHEET STATUS VALUES:
'ready' — extracted and indexed; call read_datasheet, search_datasheets, or analyze_image.
'extracting' / 'in_progress' / 'queued' / 'pending' — extraction running or scheduled. Poll check_extraction_status every 10-15s until 'ready' or 'failed'. A datasheet nobody has read before usually takes 1-3 minutes; a large one can take 5 or more.
'resolving' — we're still looking for the datasheet's PDF (distributors, then a web search; under a minute a part, longer for a big batch). Not final: keep polling check_extraction_status.
'not_extracted' — known part but datasheet hasn't been fetched yet. Trigger it via prefetch_datasheets (up to 20 parts) or by calling read_datasheet (auto-triggers on first read).
'no_source' — the search for a public datasheet has finished and found none for this MPN. Check the part number (search_parts), or retry prefetch_datasheets later. Otherwise upload the PDF via request_datasheet_upload + confirm_datasheet_upload (see those tools). Org-uploaded datasheets are private to the org.
'unsupported' — PDF exists but can't be extracted (scanned image-only, encrypted, or corrupted). Upload a clean text-based PDF via request_datasheet_upload to override.
'failed' / 'error' — extraction errored. The response includes the error reason. Retry via prefetch_datasheets or escalate to support.
'rejected' — input wasn't a real MPN (bare value like '100nF', description, or reference designator). Fix the input and re-call.
'deduplicated' — another part in the family already has this datasheet; same content is returned under the primary MPN.
| Name | Required | Description | Default |
|---|---|---|---|
| part_numbers | Yes | 1-20 MPNs to check. Must be specific manufacturer part numbers, not values or descriptions. |
compare_partsCompare PartsRead-onlyIdempotentInspect
Compare 2-5 electronic components side by side in a single call. For each part, returns merged provider data (pricing, stock, structured parameters, package) plus the cached datasheet summary if one exists, plus datasheet_status ('ready', 'extracting', or 'not_extracted').
Use this instead of calling get_part_details in a loop — it fans out provider queries in parallel and merges by MPN. For discovering candidates, use search_parts or find_alternative first; compare_parts assumes you already know which MPNs you want to compare.
Behavior:
Uses only cached datasheet summaries — does not trigger extraction. Call prefetch_datasheets first if you need summaries for parts that haven't been extracted yet.
Validates every MPN upfront. If any input is not a real part number (value, description, reference designator), the whole call is rejected with a 'rejected' map listing the offenders — other parts are not compared. Filter your list before calling.
If a valid MPN is not found at any provider, that part still appears in the response with an 'error' field; the other parts are compared normally.
IMPORTANT — part_numbers must be specific manufacturer part numbers (e.g. 'TPS54302DDCR', 'STM32F446RCT6') or LCSC numbers (e.g. 'C2837938'). Do NOT pass component values ('100nF', '10K'), descriptions ('buck converter'), or reference designators ('U3', 'R1').
Example: compare_parts(['TPS54302', 'LM2596', 'MP2359'])
DATASHEET STATUS VALUES:
'ready' — extracted and indexed; call read_datasheet, search_datasheets, or analyze_image.
'extracting' / 'in_progress' / 'queued' / 'pending' — extraction running or scheduled. Poll check_extraction_status every 10-15s until 'ready' or 'failed'. A datasheet nobody has read before usually takes 1-3 minutes; a large one can take 5 or more.
'resolving' — we're still looking for the datasheet's PDF (distributors, then a web search; under a minute a part, longer for a big batch). Not final: keep polling check_extraction_status.
'not_extracted' — known part but datasheet hasn't been fetched yet. Trigger it via prefetch_datasheets (up to 20 parts) or by calling read_datasheet (auto-triggers on first read).
'no_source' — the search for a public datasheet has finished and found none for this MPN. Check the part number (search_parts), or retry prefetch_datasheets later. Otherwise upload the PDF via request_datasheet_upload + confirm_datasheet_upload (see those tools). Org-uploaded datasheets are private to the org.
'unsupported' — PDF exists but can't be extracted (scanned image-only, encrypted, or corrupted). Upload a clean text-based PDF via request_datasheet_upload to override.
'failed' / 'error' — extraction errored. The response includes the error reason. Retry via prefetch_datasheets or escalate to support.
'rejected' — input wasn't a real MPN (bare value like '100nF', description, or reference designator). Fix the input and re-call.
'deduplicated' — another part in the family already has this datasheet; same content is returned under the primary MPN.
| Name | Required | Description | Default |
|---|---|---|---|
| part_numbers | Yes | 2-5 specific manufacturer part numbers or LCSC numbers to compare head-to-head. Must be real MPNs — the call is rejected upfront if any entry is a value, description, or reference designator. |
confirm_datasheet_uploadConfirm Datasheet UploadDestructiveInspect
Confirm a datasheet upload started via request_datasheet_upload. Pass the upload_token you got back from the request step. The server downloads the uploaded bytes, re-hashes to verify integrity, validates that it's a real PDF with the MPN on the first page, creates the private Document + Component records, charges the upload fee, and queues extraction.
Success response: document_id, mpn, sha256, file_size_bytes, status='pending'. Poll check_extraction_status with the MPN to wait for extraction to finish (usually 1-3 minutes).
Failure modes:
'upload_not_found' — no bytes at the upload URL yet. Retry your curl upload.
'sha256_mismatch' — uploaded bytes hash differs from expected_sha256. Re-compute the hash and re-request.
'invalid_pdf' — bytes aren't a parseable PDF. No charge.
'mpn_not_in_pdf' — MPN (or its stem) isn't on the first page. Either you uploaded the wrong file or it's a scanned image-only PDF. No charge.
'token_expired' — upload token is older than 15 minutes. Restart via request_datasheet_upload.
| Name | Required | Description | Default |
|---|---|---|---|
| upload_token | Yes | Opaque token returned by request_datasheet_upload. |
find_alternativeFind Alternative PartsRead-onlyIdempotentInspect
Find alternative / second-source components for a given MPN. Returns parts ranked by how closely their specs, package, and category match the reference part, with a match_score and match_notes explaining each match.
When to use:
Original part is out of stock or end-of-life.
You need a cheaper equivalent with similar specs.
You need a second source for supply-chain resilience.
You need a drop-in replacement on an existing PCB (use constraints=['same_package'], then verify pinout and dimensions).
When NOT to use:
You're browsing a category from scratch — use search_parts.
You already have candidates and want a head-to-head comparison — use compare_parts directly.
Behavior:
Eval boards, dev kits, and breakout modules are filtered out — results are IC-level alternatives only.
'same_package' uses fuzzy matching, so SOT-23 ≡ SOT23, SOIC-8 ≡ SOP-8, LQFP64 ≡ TQFP64, etc. Exact string match is not required.
Searches by function across manufacturers and compares available named electrical specs. Package data is enriched from provider parameters and cached catalogue/ordering data. Scores indicate similarity, not verified electrical or pin compatibility.
Constraints are never relaxed: unknown stock or package cannot satisfy in_stock or same_package. When nothing matches, the call returns error_type 'not_found' (not charged) with the parts that would match without the constraints, under matches_without_constraints.
Also searches the part's own family in datasheets SheetsData has already read (e.g. CH340C for CH340G).
If provider search returns few candidates, the tool falls back to semantic search across extracted datasheets to surface niche alternatives.
The response includes a 'hint' field pointing to compare_parts / read_datasheet for drilling into promising alternatives.
Example: find_alternative('TPS54302', constraints=['same_package', 'in_stock'])
DATASHEET STATUS VALUES:
'ready' — extracted and indexed; call read_datasheet, search_datasheets, or analyze_image.
'extracting' / 'in_progress' / 'queued' / 'pending' — extraction running or scheduled. Poll check_extraction_status every 10-15s until 'ready' or 'failed'. A datasheet nobody has read before usually takes 1-3 minutes; a large one can take 5 or more.
'resolving' — we're still looking for the datasheet's PDF (distributors, then a web search; under a minute a part, longer for a big batch). Not final: keep polling check_extraction_status.
'not_extracted' — known part but datasheet hasn't been fetched yet. Trigger it via prefetch_datasheets (up to 20 parts) or by calling read_datasheet (auto-triggers on first read).
'no_source' — the search for a public datasheet has finished and found none for this MPN. Check the part number (search_parts), or retry prefetch_datasheets later. Otherwise upload the PDF via request_datasheet_upload + confirm_datasheet_upload (see those tools). Org-uploaded datasheets are private to the org.
'unsupported' — PDF exists but can't be extracted (scanned image-only, encrypted, or corrupted). Upload a clean text-based PDF via request_datasheet_upload to override.
'failed' / 'error' — extraction errored. The response includes the error reason. Retry via prefetch_datasheets or escalate to support.
'rejected' — input wasn't a real MPN (bare value like '100nF', description, or reference designator). Fix the input and re-call.
'deduplicated' — another part in the family already has this datasheet; same content is returned under the primary MPN.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max alternatives to return (default 5, max 20). | |
| constraints | No | Optional filters to narrow alternatives. 'in_stock' = only parts with non-zero stock at any provider. 'same_package' = package footprint must match (fuzzy). 'jlcpcb' = must be available at JLCPCB (useful for JLCPCB-assembled boards — also restricts the provider search to JLCPCB). | |
| part_number | Yes | The MPN to find alternatives for |
find_partsFind Parts by SpecARead-onlyIdempotentInspect
Free. Find candidates by function and numeric specs with units, package or stock. Example: query='buck converter', constraints=[{parameter:'vin_max',op:'>=',value:'24 V'}, {parameter:'iout',op:'>=',value:'2 A'}]. Also accepts vds, rds_on, canonical parameter names and text constraints (interface contains I2C). Uses catalogue/JLCPCB parameters and DigiKey parametric filters when configured. Ranks pass/fail/unknown evidence; unknown is unverified. Values retain sources and test conditions. Compact columns/rows by default; verbose returns objects. Does not validate design fit.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | Yes | Function, e.g. buck converter, N-channel MOSFET, 6-axis IMU | |
| package | No | ||
| verbose | No | ||
| in_stock | No | Require positive stock observed within 24h; refresh at most six candidates. | |
| constraints | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already cover readOnly/idempotent/openWorld safety, and the description adds real behavioral context on top: evidence ranking semantics (pass/fail/unknown, unknown = unverified), source and test-condition retention, compact-vs-verbose return shape, 'Free' cost signal, and the DigiKey/JLCPCB configuration dependency. This is meaningful disclosure beyond the structured fields.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Front-loaded with the cheapest useful fact ('Free') followed by the core action, and every sentence carries distinct information about constraints, ranking, or output format. It is dense and the inline example fattens the prose, but nothing is truly wasted.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 6-parameter filtering tool with no output schema, the description covers result ranking, evidence reliability, and return shape (compact vs verbose), which is what the agent most needs. Remaining gaps are minor: limit/pagination behavior and package filtering semantics are left to the schema defaults.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
With only 33% schema coverage, the description compensates well: it shows the constraints object shape via example, clarifies value format ('24 V', '10 mΩ'), mentions text operators like 'contains', and explains verbose toggles output objects vs compact rows. It omits semantics for limit (1-20, default 5) and leaves package unelaborated, so not quite a 5.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb+resource ('Find candidates by function and numeric specs') plus scope modifiers (units, package, stock) that differentiate it from a plain keyword lookup. It implicitly separates itself from check_design_fit via 'Does not validate design fit,' but never names search_parts or find_alternative, so sibling differentiation is incomplete.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Provides a concrete usage example with query + constraints, explains what parameter naming schemes are accepted (vds, rds_on, canonical names, text constraints), and states a clear when-not boundary ('Does not validate design fit'). It stops short of routing the agent to alternatives like search_parts or find_alternative, so it is not a full 5.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_part_detailsGet Part DetailsRead-onlyInspect
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 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').
DATASHEET STATUS VALUES:
'ready' — extracted and indexed; call read_datasheet, search_datasheets, or analyze_image.
'extracting' / 'in_progress' / 'queued' / 'pending' — extraction running or scheduled. Poll check_extraction_status every 10-15s until 'ready' or 'failed'. A datasheet nobody has read before usually takes 1-3 minutes; a large one can take 5 or more.
'resolving' — we're still looking for the datasheet's PDF (distributors, then a web search; under a minute a part, longer for a big batch). Not final: keep polling check_extraction_status.
'not_extracted' — known part but datasheet hasn't been fetched yet. Trigger it via prefetch_datasheets (up to 20 parts) or by calling read_datasheet (auto-triggers on first read).
'no_source' — the search for a public datasheet has finished and found none for this MPN. Check the part number (search_parts), or retry prefetch_datasheets later. Otherwise upload the PDF via request_datasheet_upload + confirm_datasheet_upload (see those tools). Org-uploaded datasheets are private to the org.
'unsupported' — PDF exists but can't be extracted (scanned image-only, encrypted, or corrupted). Upload a clean text-based PDF via request_datasheet_upload to override.
'failed' / 'error' — extraction errored. The response includes the error reason. Retry via prefetch_datasheets or escalate to support.
'rejected' — input wasn't a real MPN (bare value like '100nF', description, or reference designator). Fix the input and re-call.
'deduplicated' — another part in the family already has this datasheet; same content is returned under the primary MPN.
| Name | Required | Description | Default |
|---|---|---|---|
| provider | No | Which provider to query: 'all' (default), 'jlcpcb', 'mouser', or 'digikey' | all |
| part_number | Yes | Specific manufacturer part number (MPN) or LCSC number (e.g. 'C2837938'). Not a value or description. | |
| prefetch_datasheet | No | Trigger background datasheet extraction (no extra charge). Default false. |
prefetch_datasheetsPrefetch DatasheetsRead-onlyInspect
Trigger background datasheet extraction for multiple parts at once (up to 20). Non-blocking — returns immediately with the status of each part. Use this to warm up datasheets for a BOM before calling read_datasheet. Example: prefetch_datasheets(['TPS54302', 'ADS1115', 'LP5907'])
A part without a known datasheet comes back 'queued' while we look for its PDF; check_extraction_status shows it as 'resolving' until the search ends. Only then is 'no_source' final: check the part number, or use request_datasheet_upload + confirm_datasheet_upload to attach your own PDF (org-private).
Part numbers must be specific MPNs (e.g. 'STM32F446RCT6', 'TPS54302DDCR') or LCSC numbers (e.g. 'C2837938'). Do NOT pass bare values ('100nF', '10K'), descriptions, BOM reference designators, test points, or board/module names — see the server instructions for the full rule set. When a BOM has values-only rows, use search_parts first to resolve each to an MPN.
DATASHEET STATUS VALUES:
'ready' — extracted and indexed; call read_datasheet, search_datasheets, or analyze_image.
'extracting' / 'in_progress' / 'queued' / 'pending' — extraction running or scheduled. Poll check_extraction_status every 10-15s until 'ready' or 'failed'. A datasheet nobody has read before usually takes 1-3 minutes; a large one can take 5 or more.
'resolving' — we're still looking for the datasheet's PDF (distributors, then a web search; under a minute a part, longer for a big batch). Not final: keep polling check_extraction_status.
'not_extracted' — known part but datasheet hasn't been fetched yet. Trigger it via prefetch_datasheets (up to 20 parts) or by calling read_datasheet (auto-triggers on first read).
'no_source' — the search for a public datasheet has finished and found none for this MPN. Check the part number (search_parts), or retry prefetch_datasheets later. Otherwise upload the PDF via request_datasheet_upload + confirm_datasheet_upload (see those tools). Org-uploaded datasheets are private to the org.
'unsupported' — PDF exists but can't be extracted (scanned image-only, encrypted, or corrupted). Upload a clean text-based PDF via request_datasheet_upload to override.
'failed' / 'error' — extraction errored. The response includes the error reason. Retry via prefetch_datasheets or escalate to support.
'rejected' — input wasn't a real MPN (bare value like '100nF', description, or reference designator). Fix the input and re-call.
'deduplicated' — another part in the family already has this datasheet; same content is returned under the primary MPN.
| Name | Required | Description | Default |
|---|---|---|---|
| part_numbers | Yes | List of MPNs to prefetch (max 20). Must be specific manufacturer part numbers, not values or descriptions. |
read_datasheetRead DatasheetRead-onlyInspect
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, returns the nearest section names and pages. Use max_chars and the returned next_offset to continue long reads.
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 (usually 1-3 minutes; poll check_extraction_status). Subsequent calls are cached.
Datasheet vs Reference Manual: Manufacturer datasheets cover high-level specs, pinout, absolute maximum ratings, and package info. For microcontrollers (STM32, nRF52, RP2040), register-level programming details (I2C CR1/CR2, DMA config, interrupt bits) are in a separate Reference Manual, not the datasheet. The summary's available_sections will show what's actually present.
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.
DATASHEET STATUS VALUES:
'ready' — extracted and indexed; call read_datasheet, search_datasheets, or analyze_image.
'extracting' / 'in_progress' / 'queued' / 'pending' — extraction running or scheduled. Poll check_extraction_status every 10-15s until 'ready' or 'failed'. A datasheet nobody has read before usually takes 1-3 minutes; a large one can take 5 or more.
'resolving' — we're still looking for the datasheet's PDF (distributors, then a web search; under a minute a part, longer for a big batch). Not final: keep polling check_extraction_status.
'not_extracted' — known part but datasheet hasn't been fetched yet. Trigger it via prefetch_datasheets (up to 20 parts) or by calling read_datasheet (auto-triggers on first read).
'no_source' — the search for a public datasheet has finished and found none for this MPN. Check the part number (search_parts), or retry prefetch_datasheets later. Otherwise upload the PDF via request_datasheet_upload + confirm_datasheet_upload (see those tools). Org-uploaded datasheets are private to the org.
'unsupported' — PDF exists but can't be extracted (scanned image-only, encrypted, or corrupted). Upload a clean text-based PDF via request_datasheet_upload to override.
'failed' / 'error' — extraction errored. The response includes the error reason. Retry via prefetch_datasheets or escalate to support.
'rejected' — input wasn't a real MPN (bare value like '100nF', description, or reference designator). Fix the input and re-call.
'deduplicated' — another part in the family already has this datasheet; same content is returned under the primary MPN.
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Reading mode: 'section' (default) returns a named section, 'search' does semantic search | section |
| limit | No | Max search results for search mode (default 3). Each result includes adjacent context chunks for continuity. | |
| query | No | Search query — REQUIRED when mode='search', ignored when mode='section'. Example: 'charge voltage register', 'I2C address'. | |
| offset | No | Continue a section using next_offset from the previous read. | |
| section | No | Section name for section mode. Start with 'summary' to discover available sections. Common: summary, pinout, electrical, abs_max, register_map, timing, package. Any heading in the datasheet works (slugified). | summary |
| max_chars | No | Text budget; a whole sentence or table row may exceed it. | |
| part_number | Yes | Specific manufacturer part number (MPN) or LCSC number. Not a value or description. |
request_datasheet_uploadRequest Datasheet UploadInspect
Request a signed URL to upload a datasheet PDF for a component whose datasheet we don't have. Use this when search_parts / get_part_details / prefetch_datasheets return datasheet_status='no_source' (once the search has finished: not while it is 'resolving') or 'unsupported'. Free — the upload fee is only charged on confirm_datasheet_upload after we validate the file.
Flow (3 steps):
Call request_datasheet_upload with the MPN, the file's SHA-256, and its byte size. You get back an upload_url, upload_method ('PUT'), upload_headers, and an opaque upload_token.
Upload the PDF directly to the returned URL with curl:
curl -X PUT -H 'Content-Type: application/pdf' --data-binary @file.pdf "$UPLOAD_URL"(add any headers from upload_headers).Call confirm_datasheet_upload with the upload_token. Server verifies the bytes, re-hashes, checks for the MPN on the first page, charges the upload fee, and queues extraction. Returns document_id + status='pending'.
Validation rules (checked at confirm time, refunded on failure):
File must be a valid PDF (magic bytes + parseable).
Actual SHA-256 must match expected_sha256.
Actual byte size must match size_bytes (±0).
MPN or its core stem must appear in the first page text (catches wrong-file uploads). Scanned image-only PDFs will fail this check — upload a text-based PDF.
Max 50MB per file. No dev-kit manuals / BOB schematics / app-notes as datasheets — use the matching MPN's actual datasheet.
Uploaded datasheets are scoped to your organization (private). They satisfy read_datasheet, search_datasheets, check_design_fit, and analyze_image for your org's tokens only.
Tokens expire after 15 minutes. If upload fails or times out, just call request_datasheet_upload again.
| Name | Required | Description | Default |
|---|---|---|---|
| size_bytes | Yes | Size of the PDF in bytes. Must be ≤ 50_000_000 (50MB) and > 1024. | |
| part_number | Yes | Manufacturer part number the PDF belongs to. Must be a real MPN, not a value or description. | |
| manufacturer | No | Optional. Manufacturer name (e.g. 'Texas Instruments') if the MPN alone doesn't disambiguate. | |
| expected_sha256 | Yes | Lowercase hex SHA-256 of the PDF bytes (64 chars). Used both as the storage key (content-addressed) and to detect tampering. Compute with `shasum -a 256 file.pdf`. |
search_datasheetsSearch DatasheetsRead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results (default 3) | |
| query | Yes | Natural language search query | |
| section_type | No | Optional: limit search to a specific section type | all |
search_partsSearch PartsRead-onlyIdempotentInspect
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 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. When the calling org has a private parts library, matching org-uploaded parts are appended to the results with source='private_library' and any tags the team has applied — including private parts whose MPN, manufacturer, description, type, category, or tag matches the query.
DATASHEET STATUS VALUES:
'ready' — extracted and indexed; call read_datasheet, search_datasheets, or analyze_image.
'extracting' / 'in_progress' / 'queued' / 'pending' — extraction running or scheduled. Poll check_extraction_status every 10-15s until 'ready' or 'failed'. A datasheet nobody has read before usually takes 1-3 minutes; a large one can take 5 or more.
'resolving' — we're still looking for the datasheet's PDF (distributors, then a web search; under a minute a part, longer for a big batch). Not final: keep polling check_extraction_status.
'not_extracted' — known part but datasheet hasn't been fetched yet. Trigger it via prefetch_datasheets (up to 20 parts) or by calling read_datasheet (auto-triggers on first read).
'no_source' — the search for a public datasheet has finished and found none for this MPN. Check the part number (search_parts), or retry prefetch_datasheets later. Otherwise upload the PDF via request_datasheet_upload + confirm_datasheet_upload (see those tools). Org-uploaded datasheets are private to the org.
'unsupported' — PDF exists but can't be extracted (scanned image-only, encrypted, or corrupted). Upload a clean text-based PDF via request_datasheet_upload to override.
'failed' / 'error' — extraction errored. The response includes the error reason. Retry via prefetch_datasheets or escalate to support.
'rejected' — input wasn't a real MPN (bare value like '100nF', description, or reference designator). Fix the input and re-call.
'deduplicated' — another part in the family already has this datasheet; same content is returned under the primary MPN.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results per provider (default 20). With providers='all', total results can be up to 3× this value (one set per provider). | |
| query | Yes | Search query (part number or keyword) | |
| providers | No | Which providers to query: 'all' (default), 'jlcpcb', 'mouser', or 'digikey' | all |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
1 tool update
- Changed
check_design_fit2 fields changed- added
Input schema / properties / efficiencyAdded value: +{ + "description": "Converter efficiency at this operating point, as a fraction (0.92) or a percentage (92). Lets the tool estimate a switching converter's junction temperature.", + "exclusiveMinimum": 0, + "maximum": 100, + "type": "number" +} - added
Input schema / properties / power_dissipationAdded value: +{ + "description": "The part's own power dissipation (W), if you have worked it out (e.g. ID² × RDS(on) for a MOSFET). Used for the junction-temperature estimate.", + "maximum": 1000, + "minimum": 0, + "type": "number" +}
2 tool updates
- Added
check_bom - Added
find_parts
2 tool updates
- Changed
read_datasheet4 fields changed- changed
Input schema / properties / limit / defaultPrevious value: -10New value: +3 - changed
Input schema / properties / limit / descriptionPrevious value: -"Max search results for search mode (default 10). Each result includes adjacent context chunks for continuity."New value: +"Max search results for search mode (default 3). Each result includes adjacent context chunks for continuity." - added
Input schema / properties / max_charsAdded value: +{ + "description": "Text budget; a whole sentence or table row may exceed it.", + "maximum": 60000, + "minimum": 500, + "type": "integer" +} - added
Input schema / properties / offsetAdded value: +{ + "default": 0, + "description": "Continue a section using next_offset from the previous read.", + "minimum": 0, + "type": "integer" +}
- Changed
search_datasheets2 fields changed- changed
Input schema / properties / limit / defaultPrevious value: -15New value: +3 - changed
Input schema / properties / limit / descriptionPrevious value: -"Max results (default 15)"New value: +"Max results (default 3)"
2 tool updates
- Changed
check_design_fit12 fields changed- added
Input schema / properties / ambient_temp / maximumAdded value: +200 - added
Input schema / properties / ambient_temp / minimumAdded value: +-65 - added
Input schema / properties / input_voltage / maximumAdded value: +1500 - added
Input schema / properties / input_voltage / minimumAdded value: +0 - added
Input schema / properties / output_current / maximumAdded value: +500 - added
Input schema / properties / output_current / minimumAdded value: +0 - added
Input schema / properties / output_voltage / maximumAdded value: +1500 - added
Input schema / properties / output_voltage / minimumAdded value: +0 - added
Input schema / properties / supply_voltage / maximumAdded value: +1500 - added
Input schema / properties / supply_voltage / minimumAdded value: +0 - added
Input schema / properties / switching_frequency / maximumAdded value: +10000000 - added
Input schema / properties / switching_frequency / minimumAdded value: +0
- Changed
read_datasheet1 field changed- changed
Input schema / properties / query / descriptionPrevious value: -"Search query for search mode (e.g. 'charge voltage register', 'I2C address')"New value: +"Search query — REQUIRED when mode='search', ignored when mode='section'. Example: 'charge voltage register', 'I2C address'."
2 tool updates
- Added
confirm_datasheet_upload - Added
request_datasheet_upload
3 tool updates
- Changed
check_extraction_status1 field changed- changed
Input schema / properties / part_numbers / descriptionPrevious value: -"List of MPNs to check (max 20)"New value: +"1-20 MPNs to check. Must be specific manufacturer part numbers, not values or descriptions."
- Changed
compare_parts1 field changed- changed
Input schema / properties / part_numbers / descriptionPrevious value: -"List of 2-5 specific manufacturer part numbers to compare. Not values or descriptions."New value: +"2-5 specific manufacturer part numbers or LCSC numbers to compare head-to-head. Must be real MPNs — the call is rejected upfront if any entry is a value, description, or reference designator."
- Changed
find_alternative6 fields changed- changed
Input schema / properties / constraints / defaultPrevious value: -""New value: +[] - changed
Input schema / properties / constraints / descriptionPrevious value: -"Optional constraints: 'in_stock' (only parts in stock), 'same_package' (must match package), 'jlcpcb' (available at JLCPCB). Comma-separated."New value: +"Optional filters to narrow alternatives. 'in_stock' = only parts with non-zero stock at any provider. 'same_package' = package footprint must match (fuzzy). 'jlcpcb' = must be available at JLCPCB (useful for JLCPCB-assembled boards — also restricts the provider search to JLCPCB)." - added
Input schema / properties / constraints / itemsAdded value: +{ + "enum": [ + "in_stock", + "same_package", + "jlcpcb" + ], + "type": "string" +} - changed
Input schema / properties / constraints / typePrevious value: -"string"New value: +"array" - changed
Input schema / properties / limit / descriptionPrevious value: -"Max alternatives to return (default 5)"New value: +"Max alternatives to return (default 5, max 20)." - added
Input schema / properties / limit / maximumAdded value: +20
2 tool updates
- Changed
check_design_fit6 fields changed- changed
Input schema / properties / ambient_temp / descriptionPrevious value: -"Ambient temperature (C)"New value: +"Ambient temperature TA (°C)." - changed
Input schema / properties / input_voltage / descriptionPrevious value: -"Input voltage (V)"New value: +"Input voltage / VIN (V). For converters." - changed
Input schema / properties / output_current / descriptionPrevious value: -"Output current (A)"New value: +"Output current / IOUT (A). For MOSFETs, this is drain current ID." - changed
Input schema / properties / output_voltage / descriptionPrevious value: -"Output voltage (V)"New value: +"Output voltage / VOUT (V). For converters/LDOs." - changed
Input schema / properties / supply_voltage / descriptionPrevious value: -"Supply voltage (V)"New value: +"Supply voltage / VCC / VDD (V). For MOSFETs, this is VDS (drain-source voltage). NOT used for power dissipation — compared against VDS(max) only." - changed
Input schema / properties / switching_frequency / descriptionPrevious value: -"Switching frequency (kHz)"New value: +"Switching frequency FSW (kHz). For converters."
- Changed
search_parts1 field changed- changed
Input schema / properties / limit / descriptionPrevious value: -"Max results per provider (default 20)"New value: +"Max results per provider (default 20). With providers='all', total results can be up to 3× this value (one set per provider)."
2 tool updates
- Changed
read_datasheet2 fields changed- changed
Input schema / properties / limit / defaultPrevious value: -5New value: +10 - changed
Input schema / properties / limit / descriptionPrevious value: -"Max search results for search mode (default 5)"New value: +"Max search results for search mode (default 10). Each result includes adjacent context chunks for continuity."
- Changed
search_datasheets2 fields changed- changed
Input schema / properties / limit / defaultPrevious value: -10New value: +15 - changed
Input schema / properties / limit / descriptionPrevious value: -"Max results (default 10)"New value: +"Max results (default 15)"
10 tool updates
- First observed
analyze_image - First observed
check_design_fit - First observed
check_extraction_status - First observed
compare_parts - First observed
find_alternative - First observed
get_part_details - First observed
prefetch_datasheets - First observed
read_datasheet - First observed
search_datasheets - First observed
search_parts
Related MCP Connectors
Verified KiCad footprints, symbols & 3D models for AI agents. No signup, CC-BY-4.0, quality-gated.
Manufacturer datasheet pages, tables, graphs and drawings for AI circuit design, cited by page.
IC datasheet search: parametric part finding, spec lookup, price comparison — grounded in real PDFs.
Search real parts with datasheet-provenance specs, check compatibility and compose priced BOMs.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables AI assistants to search millions of electronic components and ICs, retrieve specifications, compare alternates, and submit turnkey BOM procurement requests.4MIT
- FlicenseNot gradedqualityCmaintenanceEnables searching for electronic components, comparing prices across distributors, checking availability, and retrieving datasheets through the Nexar/Octopart API with specialized tools for resistors, capacitors, inductors, semiconductors, crystals, and connectors.11-
- AlicenseAqualityAmaintenanceEnables searching and filtering over 1.5 million electronic components across JLCPCB, Mouser, and DigiKey using parametric queries and smart parsing. It supports finding alternative parts, accessing pinout data, and downloading KiCad footprints directly through AI coding assistants.11126MIT
- AlicenseNot gradedqualityCmaintenanceEnables planning Arduino/ESP32/Raspberry Pi robotics builds with correct pinouts, wiring diagrams, board references, and code skeletons based on verified component specs.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.