Skip to main content
Glama

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

Partuno is published on PyPI and listed in the official MCP Registry. The recommended local MCP launcher is:

uvx --from partuno partuno-mcp

This 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-mcp

MCP 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-mcp

Use 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 partuno

See 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, and unknown evidence 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

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

Capability reference

Native MCP connection

MCP setup

Local stdio or loopback HTTP

Local deployment

Docker deployment

Docker deployment

Operator-owned Render deployment

Render reference

Azure deployment

Azure deployment

Security and credential handling

Security guide

Offline and live validation

Testing guide and validation notes

Natural-language usage examples

Examples

DigiKey, Mouser, and BOM entry points

Search-focused guides

Contributing

CONTRIBUTING.md

Security reports

SECURITY.md

Release history

CHANGELOG.md

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 tools
add_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_bomA
Read-onlyIdempotent

Analyze a BOM for cost, stock, lifecycle, lead time, compliance, PCNs, alternate packaging, and substitutes.

Inputs: request (required).

audit_lifecycleA
Read-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_barcodesA
Read-onlyIdempotent

Decode a batch of DigiKey barcodes and total received quantities by product number.

Inputs: request (required).

compare_barcodes_to_mylistB
Read-onlyIdempotent

Compare scanned received quantities against the required quantities in a DigiKey MyList.

Inputs: request (required).

compare_component_offersA
Read-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_barcodeB
Read-onlyIdempotent

Decode a DigiKey product-bag or packing-list 1D or 2D barcode.

Inputs: request (required).

delete_mylistA
Destructive

Permanently delete a DigiKey MyList after identifying it and obtaining explicit approval.

Inputs: confirm (required), list_id (required), account_id.

diff_mylistA
Read-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_changeA
Destructive

Execute only the exact, unexpired Mouser cart preview bound to the supplied one-time token.

Inputs: request (required).

get_alternate_packagingC
Read-onlyIdempotent

Get alternate packaging for the same component.

Inputs: product_number (required).

get_associated_accountsA
Read-onlyIdempotent

Get DigiKey Account IDs associated with the authenticated login.

Inputs: no named parameters.

get_categoryA
Read-onlyIdempotent

Get one DigiKey category and its parametric-search context.

Inputs: category_id (required).

get_digireel_pricingC
Read-onlyIdempotent

Calculate DigiReel pricing for a requested quantity.

Inputs: product_number (required), requested_quantity (required), account_id.

get_mouser_cartA
Read-onlyIdempotent

Read one Mouser cart. This does not modify the cart.

Inputs: cart_key (required).

get_mouser_orderA
Read-onlyIdempotent

Read one Mouser order by sales-order number or web-order number.

Inputs: request (required).

get_mylistC
Read-onlyIdempotent

Get one DigiKey MyList.

Inputs: list_id (required), account_id.

get_mylist_partsB
Read-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_quantityB
Read-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_associationsC
Read-onlyIdempotent

Get associated products and accessories.

Inputs: product_number (required).

get_product_change_notificationsB
Read-onlyIdempotent

Get PCNs with raw API dates and additive description-date diagnostics.

Inputs: product_number (required), includes.

get_product_detailsA
Read-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_mediaA
Read-onlyIdempotent

Get a product's datasheets, images, documents, and video links.

Inputs: product_number (required).

get_product_pricingC
Read-onlyIdempotent

Get current pricing and packaging variations for one DigiKey product.

Inputs: product_number (required), limit, offset, in_stock, +4 more.

get_quoteB
Read-onlyIdempotent

Get one DigiKey quote's metadata.

Inputs: quote_id (required), account_id.

get_quote_productsB
Read-onlyIdempotent

Get the products and locked pricing in a DigiKey quote.

Inputs: quote_id (required), limit, offset, account_id.

get_sales_orderA
Read-onlyIdempotent

Get shipment, tracking, backorder, and line-item status for one DigiKey sales order.

Inputs: sales_order_id (required), account_id.

get_substitutionsB
Read-onlyIdempotent

Find replacement products with the requested limit enforced upstream and locally.

Inputs: product_number (required), limit, search_options, exclude_marketplace.

list_categoriesA
Read-onlyIdempotent

Get the DigiKey product category tree and category IDs.

Inputs: no named parameters.

list_manufacturersA
Read-onlyIdempotent

List a bounded page of DigiKey manufacturers and their manufacturer IDs.

Inputs: limit, offset.

list_mylistsB
Read-onlyIdempotent

List the authenticated user's DigiKey MyLists.

Inputs: limit, account_id, start_index.

list_quotesB
Read-onlyIdempotent

List DigiKey quotes for an account.

Inputs: limit, offset, account_id.

lookup_packing_listA
Read-onlyIdempotent

Retrieve packing-list information by invoice, sales order, or purchase order number.

Inputs: request (required).

optimize_bom_pricingA
Read-onlyIdempotent

Optimize BOM pricing across package choices; unpriceable alternate packages are isolated in candidate diagnostics.

Inputs: request (required).

preview_mouser_cart_changeA
Read-onlyIdempotent

Read current cart state and preview an exact add, update, remove, replacement, order-copy, or schedule diff.

Inputs: request (required).

recommend_componentsA
Read-onlyIdempotent

Find project candidates after critical requirements are known; return pass/fail/unknown evidence and a Pareto shortlist.

Inputs: request (required).

remove_mylist_partA
Destructive

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_mylistA
Idempotent

Rename a DigiKey MyList after the user approves the exact change.

Inputs: list_id (required), request (required).

research_productB
Read-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_historyA
Read-onlyIdempotent

Read the authenticated deployment's Mouser order history by filter or date range.

Inputs: request (required).

search_mouser_productsC
Read-onlyIdempotent

Search Mouser catalog data, availability, lifecycle, compliance, and price breaks. Shipping is unavailable.

Inputs: request (required).

search_ordersB
Read-onlyIdempotent

Search the authenticated user's DigiKey orders by date.

Inputs: shared, end_date, page_size, account_id, +2 more.

search_productsA
Read-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_mylistA
Destructive

Apply an explicitly approved MyList diff. The request must contain confirm=true.

Inputs: list_id (required), request (required).

update_mylist_partA
Idempotent

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

    B3.2/5.0

    Scored across 50 tools

    Disambiguation3/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    ActivityStale
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      A
      maintenance
      This MCP server enables AI agents to understand and analyze electrical schematics from Cadence and Altium for comprehensive design reviews through natural conversations.
      11
      536 npm
      69
      Apache 2.0
    • A
      license
      B
      quality
      C
      maintenance
      Read-only MCP server for finding, comparing, and shortlisting engineering parts from distributor and marketplace APIs.
      6
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A 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.
      7
      Apache 2.0
    • A
      license
      A
      quality
      C
      maintenance
      An 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.
      8
      4
      MIT