Skip to main content

Partuno — DigiKey & Mouser MCP Server

Partuno logo

CI License Python

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
Develop from source

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

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.

Partuno turning a plain-language component request into an evidence-backed recommendation

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.

Release files for partuno 4.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for partuno 4.0.1
File Size Uploaded
partuno-4.0.1.tar.gz 107.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for partuno 4.0.1
File Interpreter ABI Platform
partuno-4.0.1-py3-none-any.whl Python 3 none any Details

Total release size: 195.3 kB

Release files / partuno-4.0.1.tar.gz

Download URL partuno-4.0.1.tar.gz
Size 107.3 kB
Tags Source
SHA-256 checksum
How to use checksums
7716bee7b647bf66e954ad7a31bfa76a70c5bbaa9e948730610f04fb34b79aff
BLAKE2b-256 checksum
How to use checksums
f672f10698e0e439dc9942dc37a69078d6d270a22617d4d7d405d6c027fbe600
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / partuno-4.0.1-py3-none-any.whl

Download URL partuno-4.0.1-py3-none-any.whl
Size 88.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1e52d8b843f7be0880ea6f89a9b5f89482faf5a5d2dffa1fa254fe8d0415e7dd
BLAKE2b-256 checksum
How to use checksums
da8d56cdaaad73728f1fdc61daeba25e9dfd360212754c71bf65bec088a6b79c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

4.0.1 This release

2 release files

4.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page