Skip to main content
Glama
Mouser MCP

Mouser MCP

by RainnWorks

Mouser MCP

Build npm License

An MCP server for the Mouser Electronics APIs. It lets Claude, or any other MCP client, search Mouser's parts, read your order history, fill your cart and place orders.

It has one tool for each endpoint in Mouser's own published API specs, so it covers all of the Search, Cart, Order and Order History APIs. It is not affiliated with Mouser.

Getting started

  1. Get your API keys. Sign in to Mouser and open the API Hub. Ask for a Search API key, and for the Order API key if you want carts, orders and order history. The Order, Cart and Order History APIs show Pending until Mouser approves them. Search works without them.

  2. Add the server to Claude Code:

    claude mcp add mouser -s user \
      -e MOUSER_SEARCH_API_KEY=your-search-key \
      -e MOUSER_ORDER_API_KEY=your-order-key \
      -- npx -y @rainnworks/mouser-mcp

    For Claude Desktop, Cursor or any other client, add this to its MCP settings:

    {
      "mcpServers": {
        "mouser": {
          "command": "npx",
          "args": ["-y", "@rainnworks/mouser-mcp"],
          "env": {
            "MOUSER_SEARCH_API_KEY": "your-search-key",
            "MOUSER_ORDER_API_KEY": "your-order-key"
          }
        }
      }
    }

    To run the latest code on main instead of the npm release, use github:RainnWorks/mouser-mcp in place of @rainnworks/mouser-mcp.

  3. Ask for a part. For example: "Find an LM317 in a TO-92 package on Mouser and show me the stock and price breaks." Claude calls post_search_keyword and shows the results.

You need Node.js 20 or later. npx downloads the server the first time the client starts it.

If you keep the keys in 1Password, read them when you add the server:

claude mcp add mouser -s user \
  -e MOUSER_SEARCH_API_KEY="$(op read 'op://Private/Mouser/Search API Key')" \
  -e MOUSER_ORDER_API_KEY="$(op read 'op://Private/Mouser/Order API Key')" \
  -- npx -y @rainnworks/mouser-mcp

Related MCP server: Mouser Electronics MCP Server

Use

API

Key

Tools

Search

MOUSER_SEARCH_API_KEY

post_search_keyword, post_search_partnumber, post_search_keywordandmanufacturer, post_search_partnumberandmanufacturer, get_search_manufacturerlist, and the v2_ versions of the last three

Order History

MOUSER_ORDER_API_KEY

get_orderhistory_bydatefilter, get_orderhistory_bydaterange, get_orderhistory_salesordernumber, get_orderhistory_webordernumber

Cart

MOUSER_ORDER_API_KEY

get_cart, post_cart, post_cart_items_insert, post_cart_items_update, post_cart_item_remove, post_cart_insert_schedule, post_cart_update_schedule, post_cart_deleteall_schedule, post_order_item_createcartfromorder

Order

MOUSER_ORDER_API_KEY

get_order_countries, get_order_currencies, post_order_options_query, get_order_by_ordernumber, post_order, post_order_createfromorder

You need only the key for the APIs you use. A tool whose key is not set returns an error that names the missing variable.

Some things to ask:

  • "What did I order from Mouser this year?"

  • "Is 595-LM317LILPR in stock, and what does 100 cost?"

  • "Add 10 of each part in this BOM to my Mouser cart."

Each tool's description and input schema come from Mouser's spec, so the client sees the same field names and notes as Mouser's own documentation.

post_order places a real order, and the cart tools change your real cart. The server marks these tools as destructive and the search and read tools as read-only. In Claude Code, allow the read-only tools and leave the others to ask each time.

How it works

flowchart LR
    A[Claude] -->|tool call| B[mouser-mcp]
    B -->|adds the Search key| C[Search API]
    B -->|adds the Order key| D[Cart, Order and<br>Order History APIs]

Mouser publishes its API as two Swagger specs, and a copy of each is in spec/. When the server starts, it turns each endpoint into a tool. The tool takes the endpoint's path, query and body fields as its input. On a call, the server adds the API key for that endpoint, sends the request to api.mouser.com, and gives back the HTTP status and Mouser's reply as it is.

Limits

  • Order, Cart and Order History need Mouser's approval. Until then, those tools return HTTP 401 with "Authorization has been denied for this request".

  • Replies are Mouser's raw JSON. The server does not trim or reshape them, so a large search uses a lot of the model's context. Ask for fewer records with records.

  • Mouser limits how many calls each key can make. A busy session can reach the limit, and Mouser then refuses calls until it resets.

  • The tools follow the copy of the specs in this repo. If Mouser changes its API, the tools change only after npm run update-specs and a new release.

Build from source

git clone https://github.com/RainnWorks/mouser-mcp
cd mouser-mcp
npm install
npm test
MOUSER_SEARCH_API_KEY=... node server.js

The server talks MCP over stdin and stdout, so it prints nothing when it starts. Use the MCP Inspector to try it by hand:

MOUSER_SEARCH_API_KEY=... npx @modelcontextprotocol/inspector node server.js

Release

Set the new version, move the [Unreleased] notes in CHANGELOG.md under it, commit, and merge. Then tag the merge commit:

git tag v$(jq -r .version package.json) && git push origin v$(jq -r .version package.json)

GitHub Actions then runs the tests, makes a GitHub release with the CHANGELOG notes, and publishes @rainnworks/mouser-mcp to npm with trusted publishing. CONTRIBUTING.md has the details.

License

Apache 2.0

Available Tools

27 tools
get_cartC
Read-only

[MouserCart] GET /api/v{version}/cart Returns the cart

Inputs: cartKey (required), version, countryCode, currencyCode.

get_order_by_ordernumberB
Read-only

[Order] GET /api/v{version}/order/{orderNumber} Returns order details for the supplied web order number.

Inputs: orderNumber (required), version.

get_order_countriesA
Read-only

[Order] GET /api/v{version}/order/countries Returns a list of countries plus any state/provinces the countries have.

Inputs: version, countryCode.

get_order_currenciesA
Read-only

[Order] GET /api/v{version}/order/currencies Returns a list of available currencies based on the billing address and default shipping address associated with the account.

Inputs: version, shippingCountryCode.

get_orderhistory_bydatefilterC
Read-only

[MouserOrderHistory] GET /api/v{version}/orderhistory/ByDateFilter Returns Order History by date filter

Inputs: dateFilter (required), version.

get_orderhistory_bydaterangeC
Read-only

[MouserOrderHistory] GET /api/v{version}/orderhistory/ByDateRange Returns Order History by date range

Inputs: endDate (required), startDate (required), version.

get_orderhistory_salesordernumberC
Read-only

[MouserOrderHistory] GET /api/v{version}/orderhistory/salesOrderNumber Returns order details for the supplied sales order number.

Inputs: salesOrderNumber (required), version.

get_orderhistory_webordernumberC
Read-only

[MouserOrderHistory] GET /api/v{version}/orderhistory/webOrderNumber Returns order details for the supplied web order number.

Inputs: webOrderNumber (required), version.

get_search_manufacturerlistA
Read-only

[SearchApi] GET /api/v1/search/manufacturerlist This method is deprecated, please use api/v2/search/manufacturerlist. Get all Manufacturer List. Return Manufacturer Name and Manufacturer ID.

Inputs: no named parameters.

post_cartA
Destructive

[MouserCart] POST /api/v{version}/cart Updates the entire cart. If any part numbers are not included with the request, they will be deleted.

Inputs: request (required), version, countryCode, currencyCode.

post_cart_deleteall_scheduleC
Destructive

[MouserCart] POST /api/v{version}/cart/deleteall/schedule Allows deleting all scheduled deliveries for cart items.

Inputs: cartKey (required), version.

post_cart_insert_scheduleC
Destructive

[MouserCart] POST /api/v{version}/cart/insert/schedule Allows adding schedule delivery(s) for cart items.

Inputs: request (required), version.

post_cart_item_removeB
Destructive

[MouserCart] POST /api/v{version}/cart/item/remove Removes an item from the cart based on mouser part number.

Inputs: cartKey (required), mouserPartNumber (required), version, countryCode, +1 more.

post_cart_items_insertC
Destructive

[MouserCart] POST /api/v{version}/cart/items/insert Allows one or more part numbers to be added to the cart

Inputs: request (required), version, countryCode, currencyCode.

post_cart_items_updateC
Destructive

[MouserCart] POST /api/v{version}/cart/items/update Updates the cart items sent in with the request.

Inputs: request (required), version, countryCode, currencyCode.

post_cart_update_scheduleC
Destructive

[MouserCart] POST /api/v{version}/cart/update/schedule Allows updating schedule delivery(s) for cart items.

Inputs: request (required), version.

post_orderA
Destructive

[Order] POST /api/v{version}/order Submits a new order if the "SubmitOrder" property is set to true. If the "SubmitOrder" property is set to false, then an order summary will be returned.

Inputs: request (required), version.

post_order_createfromorderA
Destructive

[Order] POST /api/v{version}/order/CreateFromOrder Submits a new order from an old order and if the "SubmitOrder" property is set to true. If the "SubmitOrder" property is set to false, then an order summary will be returned.

Inputs: request (required), orderNumber (required), version, countryCode, +1 more.

post_order_item_createcartfromorderC
Destructive

[MouserCart] POST /api/v{version}/order/item/CreateCartFromOrder Creates new cart from an order.

Inputs: orderNumber (required), version, countryCode, currencyCode.

post_order_options_queryB
Destructive

[Order] POST /api/v{version}/order/options/query Returns available shipping methods, payment methods, tax certificates, VAT accounts, and saved credit cards for the account.

Inputs: request (required), version.

post_search_keywordB
Read-only

[SearchApi] POST /api/v{version}/search/keyword Search parts by keyword and return a maximum of 50 parts. Please review the SearchByKeywordRequest item in the Models section below to view the detailed description of request parameters.

Inputs: request (required), version.

post_search_keywordandmanufacturerA
Read-only

[SearchApi] POST /api/v1/search/keywordandmanufacturer This method is deprecated, please use api/v2/search/keywordandmanufacturer. Search parts by keyword and specific manufacturer. Return a maximum of 50 parts. Please review the SearchByKeywordMfrRequest item in the Models section below to view the detailed description of request parameters.

Inputs: request (required).

post_search_partnumberC
Read-only

[SearchApi] POST /api/v{version}/search/partnumber Search parts by part number and return a maximum of 50 parts. Please review the SearchByPartRequest item in the Models section below to view the detailed description of request parameters.

Inputs: request (required), version.

post_search_partnumberandmanufacturerA
Read-only

[SearchApi] POST /api/v1/search/partnumberandmanufacturer This method is deprecated, please use api/v2/search/partnumberandmanufacturer. Search parts by part number and specific manufacturer. Return a maximum of 50 parts. Please review the SearchByPartMfrRequest item in the Models section below to view the detailed description of request parameters.

Inputs: request (required).

v2_get_search_manufacturerlistA
Read-only

[SearchApi] GET /api/v2/search/manufacturerlist Get all Manufacturer List. Return Manufacturer Name only.

Inputs: no named parameters.

v2_post_search_keywordandmanufacturerB
Read-only

[SearchApi] POST /api/v2/search/keywordandmanufacturer Search parts by keyword and specific manufacturer. Return a maximum of 50 parts. Please review the SearchByKeywordMfrNameRequest item in the Models section below to view the detailed description of request parameters.

Inputs: request (required).

v2_post_search_partnumberandmanufacturerC
Read-only

[SearchApi] POST /api/v2/search/partnumberandmanufacturer Search parts by part number and specific manufacturer. Return a maximum of 50 parts. Please review the SearchByPartMfrNameRequest item in the Models section below to view the detailed description of request parameters.

Inputs: request (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.8/5.0

    Scored across 27 tools

    Disambiguation2/5

    Several tool pairs appear to do the same thing: deprecated v1 and v2 variants of search/manufacturerlist and keywordandmanufacturer/partnumberandmanufacturer coexist, plus get_order_by_ordernumber vs get_orderhistory_webordernumber both fetch order details. An agent could easily misselect between the deprecated duplicates or between post_cart and post_cart_items_update, though descriptions provide some guidance.

    Naming Consistency2/5

    Naming mixes verb_resource patterns (get_cart, post_order, get_order_countries) with path-derived names (post_order_item_createcartfromorder, get_orderhistory_bydatefilter) and version prefixes (v2_get_search_manufacturerlist, v2_post_search_keywordandmanufacturer). No single predictable convention holds across the set.

    Tool Count3/5

    27 tools is on the heavy side for a procurement/ordering domain, and roughly five of them are deprecated v1 duplicates that could be dropped. The remaining surface is plausible, but the count is inflated by redundant version pairs.

    Completeness4/5

    The set covers cart operations, order submission (new and from prior order), order options/currencies/countries, part and manufacturer search, and order history lookups. Coverage is solid for the ordering domain with only minor gaps such as explicit order cancellation.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides tools to search the Mouser Electronics parts catalog via keyword, part number, and manufacturer queries using the Mouser Search API.
      3
      MIT
    • A
      license
      A
      quality
      F
      maintenance
      A Model Context Protocol (MCP) server for the Mouser Electronics API. Enables searching electronic components, managing shopping carts, and tracking orders directly through Claude or other MCP clients.
      9
      5
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Serves a product store's catalog over MCP tool calls so agents can search products, add items to a cart, inspect the cart, and complete checkout without parsing full HTML pages. This keeps action payloads and token usage far smaller than DOM scraping, especially as catalogs grow, and also works through Chrome's native document.modelContext API.
      MIT