Partuno
Partuno is a local-first MCP server for electronic component research, BOM analysis, sourcing comparison, and distributor workflows across DigiKey and Mouser.
Search & product research: Search DigiKey and Mouser catalogs using keywords, categories, manufacturers, parametric filters, packaging, tariff, RoHS, and stock status; retrieve detailed specifications, inventory, lifecycle, classifications, pricing by quantity, DigiReel pricing, media (datasheets, images), substitutions, recommendations, associations, alternate packaging, and product change notifications (PCNs).
BOM analysis & optimization: Analyze BOMs for cost, stock, lifecycle, lead time, compliance, PCNs, alternate packaging, and substitutes; optimize BOM pricing across package choices; audit lifecycle risks such as EOL, last-buy dates, shortages, and long lead times.
DigiKey account workflows: Manage MyLists/project lists (list, create, rename, delete, add/update/remove parts, diff against a BOM, sync with approved diffs); search orders and get sales order details; manage quotes (list, get, add products, create from scratch or from BOMs/MyLists). Mutating operations require explicit user approval.
Mouser account workflows: Search order history and get specific order details; read current cart; preview cart changes (add, update, remove, replace, copy from order, schedule changes); execute changes only after an explicit, unexpired confirmation token.
Logistics & reconciliation: Decode DigiKey product and packing-list barcodes (1D/2D); batch decode and total received quantities; compare scanned barcodes to MyLists for receiving reconciliation; look up packing lists by invoice, sales order, or purchase order.
Comparison & recommendations: Compare exact component offers across DigiKey and Mouser based on manufacturer, MPN, quantity, pricing, availability, MOQ, multiples, and lead time; generate AI-powered component recommendations with pass/fail/unknown evidence states and a Pareto shortlist.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Partuno Compare the onsemi LM358DR2G at qty 10 across DigiKey and Mouser."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Partuno - DigiKey & Mouser MCP Server
Local-first component intelligence for MCP
Partuno is an open-source, provider-neutral, local-first Model Context Protocol (MCP) server for electronic component research, BOM analysis, sourcing comparison, and safe distributor workflows. Connect an AI assistant to your own DigiKey and Mouser credentials without shared credentials or autonomous ordering, while keeping evidence, normalized attributes, and explicit uncertainty visible.
Partuno was initially developed as a native MCP server. Native MCP is the
recommended connection because it works as an app in ordinary ChatGPT
conversations and exposes richer tool annotations. Existing Custom GPT Action
endpoints remain available for backward compatibility, including
/action-openapi.json.
Partuno does not provide a shared public server or shared distributor credentials. The Render configuration is an optional reference deployment for an operator's own single-user instance.
Related MCP server: Parts Finder MCP
Start here
Use the published package (recommended)
Partuno is published on PyPI and listed in the official MCP Registry. The recommended local MCP launcher is:
uvx --from partuno partuno-mcpThis downloads the current published release and runs the default local stdio transport. To pin the current release exactly, use:
uvx --from 'partuno==4.0.1' partuno-mcpMCP clients that accept a local command can use uvx with these arguments:
{
"command": "uvx",
"args": ["--from", "partuno", "partuno-mcp"]
}Keep your operator-owned DigiKey and Mouser credentials in the MCP client's environment. See the local deployment guide for the supported variables and the native MCP setup guide for operator-owned remote deployments. For a hosted directory listing, see Partuno on Glama.
Install with pip
If uvx is not available, install the published package into an existing
Python environment:
python3 -m pip install partuno
partuno-mcpUse a checkout only when contributing, running unreleased changes, or needing
the repository's .env.example and test suite:
git clone https://github.com/JPMarhefka/partuno.git
cd partuno
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
cp .env.example .env
set -a
source .env
set +a
python -m partunoSee the local deployment guide for loopback HTTP and source-checkout details.
Self-host a remote MCP server
If your client requires a reachable HTTPS endpoint, deploy your own instance with your own provider accounts, OAuth application, signing key, rate limits, and hosting budget. Start with the Render reference deployment, or use the Docker and Azure guides. There is no shared Partuno endpoint intended for public use.
Use the existing Action compatibility surface
Custom GPT Actions are retained for existing integrations. The Action/OpenAPI surface is not the primary architecture; use native MCP for new connections. The Action setup details are documented in MCP setup.
What Partuno does
Searches and inspects electronic components across DigiKey and Mouser.
Normalizes manufacturer part numbers, units, compliance values, and common distributor-specific attribute names.
Compares exact component offers at a requested quantity, including price breaks, minimum order quantities, order multiples, availability, and partial provider failures.
Recommends components against hard requirements while preserving
meets,does_not_meet, andunknownevidence states.Analyzes BOMs for stock, lifecycle, compliance, pricing, tariffs, lead time, and substitute candidates.
Supports bounded account and project workflows such as read-only order history, list and quote previews, receiving reconciliation, and carefully confirmed mutations where the provider supports them.
See the capability reference for the current scope and the safety boundary for each workflow.
DigiKey MCP server
Partuno can run as a local-first DigiKey MCP server for component search, product research, current pricing and availability, lifecycle checks, MyLists, quotes, receiving reconciliation, and other bounded account workflows. The DigiKey MCP server guide covers setup, supported workflows, and the provider-specific safety boundaries.
Mouser MCP server
Partuno also provides a Mouser MCP server surface for catalog search, exact offer comparison, read-only order history, and preview-confirmed Cart workflows. The Mouser MCP server guide explains the separate operator-owned Mouser credentials and what the server does and does not execute.
Electronics BOM MCP server
Use Partuno as an electronics BOM MCP server to consolidate duplicate rows, resolve exact products, estimate current merchandise cost, check stock and lifecycle risk, inspect compliance and lead-time signals, and find substitutes or alternate packaging. See the electronics BOM MCP server guide for a complete read-only example and known limitations.
AI component sourcing
Partuno turns a natural-language engineering request into a traceable sourcing
workflow. Recommendations preserve meets, does_not_meet, and unknown
evidence states, so missing or ambiguous attributes are not silently treated as
qualified requirements. The natural-language examples
show the intended interaction style.
DigiKey vs Mouser comparison
For an exact comparison, Partuno matches manufacturer and MPN identity first, then compares requested-quantity pricing, minimum order quantity, order multiples, purchasable quantity, availability, and manufacturer lead time. If a provider fails or returns incomplete evidence, the result remains partial instead of inventing a winner. See the DigiKey vs Mouser comparison guide.
What Partuno does not do
It does not supply DigiKey or Mouser credentials.
It does not create a shared multi-tenant credential pool.
It does not silently turn unknown product data into a pass.
It does not submit distributor orders.
It does not bypass provider quotas, terms, authentication, or rate limits.
See it in action
Featured example: choose a component for a 3.3 V design
Once Partuno is connected, a user can simply ask:
I’m choosing a dual op amp for a 3.3 V circuit. Find a few LM358-family
options that can operate at 3.3 V, are RoHS compliant, normally stocked, and
available in a quantity of 10. Show the evidence behind each recommendation
and keep uncertain data clearly marked.Partuno turns that plain-language request into a provider-aware result with qualified, unverified, and rejected candidates; normalized voltage and compliance evidence; cross-distributor availability; quantity pricing; and a Pareto shortlist. It does not silently treat missing specifications as a pass.
This is a roughly 10-second prompt-to-result capture that shows the request and a smooth response scroll. Prices, stock, and lead times are live provider data and can change.
See more natural-language examples for comparison, product research, BOM review, and safe account-preview workflows.
Documentation
Topic | Guide |
Capabilities and safety boundaries | |
Native MCP connection | |
Local stdio or loopback HTTP | |
Docker deployment | |
Operator-owned Render deployment | |
Azure deployment | |
Security and credential handling | |
Offline and live validation | |
Natural-language usage examples | |
DigiKey, Mouser, and BOM entry points | |
Contributing | |
Security reports | |
Release history |
Logo assets
The full-resolution Partuno logo is available for project pages, client listings, and integration documentation. A compact plugin icon is also included for client or plugin upload fields with strict PNG size limits.
The compact icon is intentionally optimized for small upload limits. If a host accepts larger assets, use the full-resolution logo instead. The compact icon can also be downloaded directly from the repository's raw asset URL.
When using the logo in a ChatGPT app, MCP client, or other plugin integration, identify the integration as Partuno and do not imply endorsement by DigiKey, Mouser, or another provider. Check the host platform's current dimensions, format, and file-size requirements before uploading.
Deployment and credential model
Mode | Best for | Credential ownership |
Local stdio | Desktop MCP clients and personal development | Operator's local environment |
Loopback HTTP | Clients that cannot launch stdio | Operator's local environment |
Remote HTTPS | A self-hosted ChatGPT/Codex connection | Operator's own deployment and accounts |
Remote mode adds OAuth and HTTPS because a hosted MCP endpoint must authenticate the client and protect upstream access. It is optional; local mode remains the default and does not require Partuno OAuth.
Project status
Partuno 4.0.1 is an active open-source release. The test suite covers offline provider contracts, MCP tool behavior, REST compatibility, credential safety, normalization, and the multi-distributor workflows. Live provider calls are opt-in because they require operator credentials and are subject to provider quotas.
See testing before running live smoke tests.
License and independence
Partuno is released under the Apache License 2.0. See NOTICE for project attribution and independence statements. Partuno is not affiliated with, endorsed by, or sponsored by DigiKey, Mouser, or any manufacturer or distributor named in the project. Their names and marks identify integrations only.
Available Tools
50 toolsadd_parts_to_mylistC
Add approved products, packaging, and quantities to a DigiKey MyList.
Inputs: list_id (required), request (required).
add_products_to_quoteA
Add explicitly approved product quantities to a DigiKey quote.
Inputs: request (required), quote_id (required).
analyze_bomARead-onlyIdempotent
Analyze a BOM for cost, stock, lifecycle, lead time, compliance, PCNs, alternate packaging, and substitutes.
Inputs: request (required).
audit_lifecycleARead-onlyIdempotent
Audit a BOM or MyList for end-of-life risk, last-buy dates, shortages, long lead times, PCNs, and substitutes.
Inputs: request (required).
batch_decode_barcodesARead-onlyIdempotent
Decode a batch of DigiKey barcodes and total received quantities by product number.
Inputs: request (required).
compare_barcodes_to_mylistBRead-onlyIdempotent
Compare scanned received quantities against the required quantities in a DigiKey MyList.
Inputs: request (required).
compare_component_offersARead-onlyIdempotent
Compare strict manufacturer-plus-MPN matches at requested quantities across DigiKey and Mouser.
Inputs: request (required).
create_mylistA
Create a DigiKey MyList after the user approves the exact name.
Inputs: request (required).
create_quoteA
Create an empty DigiKey quote after explicit approval.
Inputs: request (required).
create_quote_from_sourceA
Create and populate a quote from an explicitly approved BOM or MyList. The request must contain confirm=true.
Inputs: request (required).
decode_barcodeBRead-onlyIdempotent
Decode a DigiKey product-bag or packing-list 1D or 2D barcode.
Inputs: request (required).
delete_mylistADestructive
Permanently delete a DigiKey MyList after identifying it and obtaining explicit approval.
Inputs: confirm (required), list_id (required), account_id.
diff_mylistARead-onlyIdempotent
Dry-run a proposed BOM against a MyList and show additions, updates, removals, duplicates, and unchanged rows.
Inputs: list_id (required), request (required).
execute_mouser_cart_changeADestructive
Execute only the exact, unexpired Mouser cart preview bound to the supplied one-time token.
Inputs: request (required).
get_alternate_packagingCRead-onlyIdempotent
Get alternate packaging for the same component.
Inputs: product_number (required).
get_associated_accountsARead-onlyIdempotent
Get DigiKey Account IDs associated with the authenticated login.
Inputs: no named parameters.
get_categoryARead-onlyIdempotent
Get one DigiKey category and its parametric-search context.
Inputs: category_id (required).
get_digireel_pricingCRead-onlyIdempotent
Calculate DigiReel pricing for a requested quantity.
Inputs: product_number (required), requested_quantity (required), account_id.
get_mouser_cartARead-onlyIdempotent
Read one Mouser cart. This does not modify the cart.
Inputs: cart_key (required).
get_mouser_orderARead-onlyIdempotent
Read one Mouser order by sales-order number or web-order number.
Inputs: request (required).
get_mylistCRead-onlyIdempotent
Get one DigiKey MyList.
Inputs: list_id (required), account_id.
get_mylist_partsBRead-onlyIdempotent
Get every MyList part; compact is bounded and default, while full preserves the raw DigiKey shape.
Inputs: list_id (required), account_id, assemblies, include_images, +6 more.
get_pricing_by_quantityBRead-onlyIdempotent
Compare exact, effective-MOQ, BetterValue, and maximum-order options; parent availability remains distinct from package stock.
Inputs: product_number (required), requested_quantity (required), includes, account_id.
get_product_associationsCRead-onlyIdempotent
Get associated products and accessories.
Inputs: product_number (required).
get_product_change_notificationsBRead-onlyIdempotent
Get PCNs with raw API dates and additive description-date diagnostics.
Inputs: product_number (required), includes.
get_product_detailsARead-onlyIdempotent
Get current specifications, inventory, lifecycle, classifications, variations, and account pricing for one product.
Inputs: product_number (required), includes, account_id, manufacturer_id.
get_product_mediaARead-onlyIdempotent
Get a product's datasheets, images, documents, and video links.
Inputs: product_number (required).
get_product_pricingCRead-onlyIdempotent
Get current pricing and packaging variations for one DigiKey product.
Inputs: product_number (required), limit, offset, in_stock, +4 more.
get_quoteBRead-onlyIdempotent
Get one DigiKey quote's metadata.
Inputs: quote_id (required), account_id.
get_quote_productsBRead-onlyIdempotent
Get the products and locked pricing in a DigiKey quote.
Inputs: quote_id (required), limit, offset, account_id.
get_recommended_productsCRead-onlyIdempotent
Get DigiKey recommendations; explicit filters rejected with 404/500 are retried once without filters and marked.
Inputs: product_number (required), limit, search_options, exclude_marketplace.
get_sales_orderARead-onlyIdempotent
Get shipment, tracking, backorder, and line-item status for one DigiKey sales order.
Inputs: sales_order_id (required), account_id.
get_substitutionsBRead-onlyIdempotent
Find replacement products with the requested limit enforced upstream and locally.
Inputs: product_number (required), limit, search_options, exclude_marketplace.
list_categoriesARead-onlyIdempotent
Get the DigiKey product category tree and category IDs.
Inputs: no named parameters.
list_manufacturersARead-onlyIdempotent
List a bounded page of DigiKey manufacturers and their manufacturer IDs.
Inputs: limit, offset.
list_mylistsBRead-onlyIdempotent
List the authenticated user's DigiKey MyLists.
Inputs: limit, account_id, start_index.
list_quotesBRead-onlyIdempotent
List DigiKey quotes for an account.
Inputs: limit, offset, account_id.
lookup_packing_listARead-onlyIdempotent
Retrieve packing-list information by invoice, sales order, or purchase order number.
Inputs: request (required).
optimize_bom_pricingARead-onlyIdempotent
Optimize BOM pricing across package choices; unpriceable alternate packages are isolated in candidate diagnostics.
Inputs: request (required).
preview_mouser_cart_changeARead-onlyIdempotent
Read current cart state and preview an exact add, update, remove, replacement, order-copy, or schedule diff.
Inputs: request (required).
recommend_componentsARead-onlyIdempotent
Find project candidates after critical requirements are known; return pass/fail/unknown evidence and a Pareto shortlist.
Inputs: request (required).
remove_mylist_partADestructive
Permanently remove one identified part from a DigiKey MyList after explicit approval.
Inputs: confirm (required), list_id (required), unique_id (required), account_id, +1 more.
rename_mylistAIdempotent
Rename a DigiKey MyList after the user approves the exact change.
Inputs: list_id (required), request (required).
research_productBRead-onlyIdempotent
Get product details plus optional enrichments; partial failures are returned under errors without discarding successful results.
Inputs: request (required), account_id.
search_mouser_order_historyARead-onlyIdempotent
Read the authenticated deployment's Mouser order history by filter or date range.
Inputs: request (required).
search_mouser_productsCRead-onlyIdempotent
Search Mouser catalog data, availability, lifecycle, compliance, and price breaks. Shipping is unavailable.
Inputs: request (required).
search_ordersBRead-onlyIdempotent
Search the authenticated user's DigiKey orders by date.
Inputs: shared, end_date, page_size, account_id, +2 more.
search_productsARead-onlyIdempotent
Search DigiKey with native filters; a marked fallback removes explicitly non-matching tariff or Marketplace variations only when DigiKey returns them.
Inputs: request (required).
sync_mylistADestructive
Apply an explicitly approved MyList diff. The request must contain confirm=true.
Inputs: list_id (required), request (required).
update_mylist_partAIdempotent
Update an approved MyList part while preserving every field omitted from the request.
Inputs: list_id (required), request (required), unique_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 50 tools
Many tools target the same resource (e.g., product, quote, MyList) with different actions, but the descriptions clearly differentiate purposes such as pricing comparisons versus standard pricing, or full BOM analysis versus lifecycle-only audit. Some overlap exists between analyze_bom and audit_lifecycle, but the detailed descriptions help an agent choose correctly.
All tool names follow a consistent snake_case verb_noun pattern (e.g., list_quotes, create_mylist, optimize_bom_pricing). Varied verbs are present but the structure is uniform, making the naming predictable and easy to navigate.
With 50 tools, the server is heavily over-scoped even for a broad domain covering DigiKey and Mouser integrations, BOM management, and barcode processing. Many tools are granular (e.g., get_product_media, get_alternate_packaging) and could be consolidated into broader operations, making the count excessive.
The tool surface is quite comprehensive for component research, BOM analysis, and quote/MyList management, covering search, details, pricing, lifecycle, substitutions, and cross-supplier comparisons. Minor gaps exist, such as the absence of update/delete operations for quotes, but the overall domain coverage is strong.
Maintenance
Related MCP Connectors
One MCP server over 253 data sources: Reddit, LinkedIn, YouTube, G2, search and AI answers.
One MCP server for all web data. Scrape, search, crawl, and AI research in one install.
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
MCP server for VC pitch-deck scoring, thesis-fit matching, and deal-flow management.
Related MCP Servers
- AlicenseAqualityAmaintenanceThis MCP server enables AI agents to understand and analyze electrical schematics from Cadence and Altium for comprehensive design reviews through natural conversations.11536 npm69Apache 2.0
- AlicenseBqualityCmaintenanceRead-only MCP server for finding, comparing, and shortlisting engineering parts from distributor and marketplace APIs.6MIT
- AlicenseAqualityDmaintenanceA read-only MCP server for electronics engineers to search DigiKey parts, get detailed product information, plan and validate BOMs, and export order lists, using the official DigiKey API.7Apache 2.0
- AlicenseAqualityCmaintenanceAn MCP server that picks JLCPCB/LCSC parts for KiCad circuits with assembly cost in mind, automating part selection, stock risk checks, and quantity-tiered pricing.84MIT