Nc Dmv MCP server

@pipeworx/nc-dmv

North Carolina DMV MCP — live wait times at every NCDMV driver license office and license plate agency, plus the office directory the same feed carries. Keyless.

Part of Pipeworx — an MCP gateway connecting AI agents to 1476+ live data sources.

North Carolina and Oregon are the only two US states whose DMV publishes a machine-readable live wait feed. Every other state's is captcha-gated, blocked to cloud egress, broken, or only inside a phone app.

Tools

longest wait, and open/closed status per office. 148 driver license offices; service: "vehicle" switches to the vehicle services / license plate agency units.

• ncdmvwaittimes(office?, service?, openonly?, sort?, limit?) — current average wait,

phone, posted hours and NCDMV district. This feed is the only machine-readable NCDMV office directory that exists, so it doubles as the state's office locator.

• ncdmvoffices(office?, city?, zip?, service?, district?, limit?) — address, city, ZIP,

Auth

None. Keyless and unauthenticated.

Data source

https://wait.services.ncdot.gov/IWT/IWTWeb/XmlStats.aspx?controller=IWT_UnitsListXML&UnitID=

Gotchas this pack handles for you

Closed-hours zeros are data, not gaps

Outside posted business hours every office reports OfficeStatus Closed with AvgWT/MaxWT of 0:00:00. That is NCDMV reporting an idle queue — it is neither an error nor a missing value, and it must not be read as "walk right in".

Responses therefore always carry offices_open, and when nothing is open the note says the wait figures are idle-queue zeros. sort: "wait" puts open offices ahead of closed ones for the same reason: a shortest-wait ranking would otherwise be won by 148 closed offices tied at zero.

The feed is a tree, and the sentinel row lies about its parent

UnitID=2 returns 161 blocks: one root (Driver Services, UnitLevel 1), eleven districts (level 2), the 148 real offices (level 3), and a sentinel named Invalid. For UnitID=182 the real unit sits at level 2 instead.

So the pack keeps leaves — any UnitId never named as another unit's ParentUnitId — rather than filtering on UnitLevel, which survives NCDOT re-organising the tree.

The ordering matters: the Invalid sentinel hangs off a real office (Greensboro West, ParentUnitId=143). Computing the parent set before dropping Invalid demotes that office out of the results and yields 147 offices where NCDMV publishes 148. Invalid is dropped first.

Addresses

-- is the feed's null. The separate tag is empty on every single unit, so the ZIP has to be parsed out of the one-line Address string ("521 S. Sandhills Blvd., Aberdeen, NC 28315"). That line is not consistently punctuated: some offices embed newlines, omit the comma before the city, or drop NC altogether ("2479 E. Fifth St., Lumberton 28358"). The parser peels from the right — ZIP, then the state token, then the city at the last comma — and returns the whole string in address with city: null when the city cannot be separated from the street safely.

Current coverage: 118 of 148 offices carry an address at all (NCDMV leaves 30 blank); of those, 118 ZIPs and 116 cities parse. officesmissingaddress reports the gap.

Some entries are stale on NCDMV's side — Greensboro Express OLD still appears in the feed. They are returned as published rather than second-guessed.

Wait units

AvgWT / MaxWT are H:MM:SS; the pack converts them to whole minutes.

Related

• ordmvwaittimes / ordmv_offices — Oregon, the other live state wait feed.
• cadmvoffices — California field offices (no wait feed published).

Quick Start

Shortened. The full README is on GitHub.