Urdb Mcp

io.github.GetMystAdminPublished by GitHub account GetMystAdminv1.0.2Updated Nov 3, 2026

Search URDB for product integrity scores, enshittification events, and change tracking.

VerifiedSTDIODesktop onlyDeveloper ToolsBusiness & Commerce

Overview

AI-generated overview

Local MCP server for URDB that gives an assistant 76 electronics, hardware and firmware calculators plus product integrity scores and change history.

What you can do
  • Run engineering calculators for components, circuits, power and wiring, firmware, RF and signals, mechanical parts and reference data, each returning the answer, machine-readable values and a worked derivation
  • Search products by name or keyword and see their integrity scores
  • Fetch a product's full integrity breakdown across seven dimensions
  • List and filter products by category, brand or score
  • Retrieve documented downgrade, shrinkflation and warranty-cut events for a product
When to use it
Useful when an assistant helps with electronics or firmware design and needs exact calculated values rather than estimates, or when you want to check whether a product has degraded over time before buying or recommending it.
Requirements
Runs locally over stdio, typically via npx, so Node.js is needed. Requires a URDB API key in the URDB_API_KEY environment variable, obtainable from the provider's settings page; an optional URDB_API_URL overrides the API base. Network access to the URDB API is required for calculators and product data.
Before you install
The API key is passed in plain environment configuration and sent to the URDB API. The package is a thin proxy: the calculator catalogue and tool schemas are fetched from the remote API at startup, so tool definitions come from the server rather than the installed package. Product queries and calculator inputs are sent to a third party. Free-tier calculator usage is capped per day.

Installation

In SourceWeft

  1. Open Urdb Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

urdb-mcp

[Image]

MCP server for URDB. Gives your AI assistant 76 electronics, hardware and firmware calculators — plus the product integrity database tracking downgrades, shrinkflation, warranty cuts and enshittification.

Ask "what UBRR do I need for 9600 baud on a 16 MHz AVR?" and get 103 with the error percentage and the worked derivation, instead of a plausible-sounding guess.

Setup

1. Get an API key at urdb.io/settings/api-keys (free tier available)

2. Add to your MCP host

Claude Desktop config lives at ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows).

json
{  "mcpServers": {    "urdb": {      "command": "npx",      "args": ["urdb-mcp"],      "env": {        "URDB_API_KEY": "urdb_live_your_key_here"      }    }  }}

3. Restart your host

Calculators are metered separately from product data — 1,000 calculator calls a day on the free tier, so an agent working through a design won't exhaust your quota on arithmetic.

Example prompts

  • "Size the current-limiting resistor for a blue LED on 5 V"
  • "Give me every valid CAN bit timing for 500 kbit/s on a 40 MHz clock"
  • "What trace width do I need for 3 A with a 20 °C rise on an external layer?"
  • "Decode this struct's padding for a 32-bit target"
  • "Is 1000 km realistic on LoRa SF12?"
  • "Which laptops have the highest integrity scores?"
  • "Has the KitchenAid Stand Mixer gotten worse over the years?"

Tools

Call tools/list to see the current set — the calculator catalogue is fetched from the server at runtime, so it grows without a package update.

Calculators

76 tools across seven categories, named calc_<name>:

CategoryCovers
Components (11)Resistor and capacitor colour/SMD codes, E-series snapping, LED resistors, RC time constants, series/parallel networks
Circuits (16)555 timers, op-amps, filters, buck/boost converters, MOSFET gate drive, Ohm's law, zener and LM317 regulators, Schmitt triggers
Power & Wiring (13)PCB trace width and impedance, wire gauge, voltage drop, fuse sizing, heat sinks, battery packs, solar sizing, via current
Firmware (22)UART baud rates, CAN bit timing, PLL dividers, timer prescalers, CRC, IEEE 754, struct padding, bitfields, watchdogs, Intel HEX
RF & Signals (7)Antenna lengths, LoRa airtime, path loss, VSWR, Nyquist, FFT bins, wavelength
Mechanical (4)Stepper motors, E-steps, gear ratios, tap drill sizes
Reference (3)Pinouts, logic levels, MCU comparison

Each returns the answer, machine-readable values, the worked derivation and a link to the same tool on the web at https://urdb.io/tools/<name>.

Product data

ToolDescription
urdb_searchSearch products by name or keyword, with integrity scores
urdb_get_productFull integrity breakdown across 7 dimensions
urdb_get_changesDocumented enshittification events for a product
urdb_list_productsList/filter products by category, brand, score

How it works

This package is a thin stdio→HTTPS proxy for https://urdb.io/api/v1. It contains no calculation logic: the catalogue and every tool's JSON Schema are fetched from /api/v1/tools when the server starts.

That means a calculator added to URDB shows up here on your next restart, and a fix reaches you via a deploy rather than npm update. If the API is unreachable the server still starts and serves the product tools, and retries the catalogue on the next tools/list.

Calculators follow published standards where one exists — IPC-2221 and IPC-2141 for trace geometry, IEC 60063 for E-series, IEC 60127 for fuses, ISO 11898-1 for CAN, IEEE 754 for floats. Where a result is an extrapolation rather than a measurement, the tool says so.

REST API

Everything here is available over plain HTTP:

bash
curl -H "Authorization: Bearer $URDB_API_KEY" https://urdb.io/api/v1/tools
curl -X POST https://urdb.io/api/v1/tools/uart-baud-rate \  -H "Authorization: Bearer $URDB_API_KEY" \  -H "Content-Type: application/json" \  -d '{"clockHz": 16000000, "baud": 9600, "family": "avr-normal"}'

Full docs: urdb.io/api

Configuration

VariableRequiredDescription
URDB_API_KEYyesYour key from urdb.io/settings/api-keys
URDB_API_URLnoAPI base URL. Defaults to https://urdb.io/api/v1.

Development

bash
npm run typechecknpm run build     # bundle to dist/index.jsnpm test          # stdio end-to-end against a mock API

License

MIT

Source: README.md at commit 3174463

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts