UDS Toolbox MCP server
Commit Nov 4, 2026Decodes UDS, ISO-TP, and DTCs from CAN traces to diagnose UDS flash failures without hardware.
Also known as Artomatica/udslib.com, uds-toolbox
- Stars
- 0
- Tools
- 7
- Downloads, 30 days
- —
- Latest version
- 1.1.0
- Last commit
- Nov 4, 2026
- License
- —
What is UDS Toolbox MCP?
UDS Toolbox decodes UDS, ISO-TP, and DTCs from CAN traces to diagnose UDS flash failures without hardware. It exposes 7 tools, such as analyze_trace, decode_uds, build_uds_request.
Summary generated from the project's README
How to install UDS Toolbox MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall UDS Toolbox MCP in Claude Code
$ claude mcp add --transport http uds-toolbox https://mcp.udslib.com/mcpInstall UDS Toolbox MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"uds-toolbox": {
"url": "https://mcp.udslib.com/mcp"
}
}
}Install UDS Toolbox MCP in VS Code
.vscode/mcp.json
{
"servers": {
"uds-toolbox": {
"type": "http",
"url": "https://mcp.udslib.com/mcp"
}
}
}Install UDS Toolbox MCP in VS Code CLI
$ code --add-mcp '{"name":"uds-toolbox","type":"http","url":"https://mcp.udslib.com/mcp"}'Install UDS Toolbox MCP in Codex
$ codex mcp add uds-toolbox --url https://mcp.udslib.com/mcpInstall UDS Toolbox MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.uds-toolbox] url = "https://mcp.udslib.com/mcp"
Install UDS Toolbox MCP in Gemini CLI
$ gemini mcp add -s user --transport http uds-toolbox https://mcp.udslib.com/mcpInstall UDS Toolbox MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"uds-toolbox": {
"url": "https://mcp.udslib.com/mcp",
"type": "http"
}
}
}UDS Toolbox MCP tools 7
Read from the server with tools/listanalyze_traceRead-onlyAnalyze a whole CAN trace of a UDS diagnostic or flash session and say what went wrong. Accepts candump logs, Vector ASC, PEAK TRC (1.x/2.x), SavvyCAN or python-can CSV pasted as text, and those plus Vector BLF, Wireshark pcap/pcapng (SocketCAN) and ASAM MF4 bus logging uploaded as a file. Reassembles ISO-TP, pairs requests with responses (including 0x78 responsePending), measures P2/P2*, follows sessions and security access, reconstructs RequestDownload/TransferData into an image with CRC32, extracts identification DIDs, and returns a root-cause finding with the frames that show it. Shows an interactive timeline.
decode_udsRead-onlyDecode a UDS (ISO 14229-1) PDU from hex: request, positive or negative response. Names the service, sub-function (and suppressPosRsp bit), DID/RID/address fields, and for negative responses the NRC with meaning and typical cause. Unknown SIDs and NRCs are labelled, not rejected.
build_uds_requestRead-onlyBuild a UDS request as hex with an annotated breakdown. Services: session, ecu_reset, read_did, write_did, security_seed, security_key, tester_present, routine, request_download, transfer_data, transfer_exit, clear_dtc, read_dtc, control_dtc, comm_control, raw. Numeric strings are hex.
decode_isotpRead-onlyReassemble ISO-TP (ISO 15765-2) messages from CAN frames, per CAN id, and decode each as UDS. Reports frame types (SF/FF/CF/FC), flow-control BS/STmin, sequence-number errors, interrupted messages, padding, and N_Bs/N_Cr/STmin timing warnings when timestamps (ms) are given. Accepts a frame list or a candump text dump.
decode_dtcRead-onlyConvert a 3-byte UDS DTC to the SAE J2012 style code (P/C/B/U + digits) plus failure type byte, or the reverse ("U0073-00" to hex). With a status byte, explains each of the 8 DTC status bits.
uds_referenceRead-onlyShort UDS reference with ISO 14229-1 clause pointers (paraphrased). Topics: a service ID (0x27) or name, an NRC (0x78 or "nrc 78"), a DID (F190) or RID (FF00), timing (p2, p2*, s3), sessions, security (0x27 vs 0x29), reprogramming_sequence. Unknown topics return a topic list.
udslib_integrationRead-onlyPlan how to integrate the UDSLib C stack (ISO 14229 UDS server/client for embedded ECUs): which repo files to take, Kconfig/config hints, an init skeleton, the closest example, and the license terms (free noncommercial / commercial). UDSLib speaks ISO-TP over CAN/CAN-FD; DoIP is not supported.
Automated checks
Ran Nov 16, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableartomatica/udslib.com is public and reachablegithub.com/artomatica/udslib.com ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-04github.com/artomatica/udslib.com ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model7 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 66 ms; tools/list returned 7 toolsPass
UDS Toolbox MCP questions
How do I add UDS Toolbox MCP to Claude Code?
Run claude mcp add --transport http uds-toolbox https://mcp.udslib.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add UDS Toolbox MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does UDS Toolbox MCP provide?
It exposes 7 tools, including analyze_trace, decode_uds, build_uds_request, decode_isotp, decode_dtc.