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.

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

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

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

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

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.

Read the full README on GitHub →