npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@pipeworx/mcp-tn-dmv

v0.2.1

Published

Tennessee DMV MCP — Department of Safety and Homeland Security: the 186 driver service centers with their per-center service capabilities, and the state's impaired-driving crash file. Keyless.

Readme

@pipeworx/tn-dmv

Tennessee Department of Safety and Homeland Security: the 186 driver service centers with their per-location service capabilities, plus the state's impaired-driving crash file. Keyless.

Part of Pipeworx — an MCP gateway connecting AI agents to 1866+ live data sources. This is an independent, unofficial integration — not affiliated with, endorsed by, or published by the upstream provider.

Why Tennessee gets its own pack

This came out of splitting a single multiplexed us-dmv tool into one pack per state agency. Tennessee's grain is a per-counter capability matrix — REAL ID, CDL skills test, handgun permit, vision test — published on the department's own ArcGIS, which has nothing in common with California's ZIP-level registration snapshot. A union schema across states leaves most arguments ignored on every call, so Tennessee's arguments are Tennessee's.

Tools

| Tool | What it returns | |---|---| | tn_dmv_driver_service_centers | Address, county, hours, phone, coordinates and the 21 service capabilities each location publishes | | tn_dmv_impaired_driving_crashes | Alcohol- and drug-involved injury and fatal crashes for 2022, grouped by age, gender, severity, agency, substance or month, with a mappable sample |

tn_dmv_driver_service_centers filters: city, county, zip (prefix), name, service, limit. tn_dmv_impaired_driving_crashes filters: substance, severity, age_group, gender, agency, group_by, limit.

The distinctive fields

REAL ID, CDL skills test (only 4 of 186 locations do it), handgun permit (47 locations) and vision test are the filters worth knowing about — they are the questions a plain address list cannot answer. office_type separates the 44 full-service centers from 93 self-service kiosks, 46 county-clerk partners and 3 express counters, which matters because a kiosk performs only a handful of the listed services.

Auth

None. tnmap.tn.gov is a public state ArcGIS host.

Gotchas worth knowing

  • City names run together. USER_City is published as OakRidge, MtJuliet and similar, so city is matched after stripping both sides to letters and digits — a caller typing "Oak Ridge" gets the Oak Ridge center rather than a not-found.
  • X is longitude and Y is latitude, both as attribute columns, so no geometry round-trip is needed.
  • Two HTML blob columns had to be excluded. USER_Website_Name and USER_Website_Services are pre-rendered <br>-separated markup that duplicates columns already returned and roughly triples the payload; with them included the full-layer fetch failed outright rather than merely running slowly. The query names its fields explicitly to leave them behind.
  • The crash layer is person-level, and 2022 only. SAFETY/DUICrashesArrestsAgeGender layer 0 holds one row per person involved: ~1,543 person records across ~603 distinct crashes. Both numbers are reported (person_records, distinct_crashes) because quoting the row count as a crash count would overstate it by 2.5×. It covers injury and fatal crashes; property-damage-only crashes sit outside it. The whole file is calendar year 2022, reported as as_of.
  • State troopers are not called "Highway Patrol" in the data. They appear as THP District 3 - Nashville and seven other districts, so agency: "THP" selects all of them; agency: "HIGHWAY PATROL" matches nothing.
  • "Unknown" is a real age group, the agency's own value for records where age was never recorded, and it is the largest bucket (386 of 1,543). It is left in rather than silently dropped.
  • The wider SAFETY/ ArcGIS folder also carries DeerCrashes2019to2023 and I24_CrashHotspots. Both are cartographic multi-layer map services (severity-split display layers, basemap boundaries, a weighted-likelihood raster) rather than one queryable table, so they are left out; the DUI layer was the one that returned real, aggregatable records.

Data sources

Both verified live 2026-07-30.

Quick Start

Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "tn-dmv": {
      "url": "https://gateway.pipeworx.io/tn-dmv/mcp"
    }
  }
}

What this endpoint actually serves

tools/list at https://gateway.pipeworx.io/tn-dmv/mcp returns the tools in the table above plus the shared Pipeworx meta-tools — ask_pipeworx, discover_tools, search_within, remember/recall and the rest of the gateway-wide set. So the tool count you see is larger than this table: a single-pack endpoint currently lists roughly 30 shared tools alongside the pack's own. The connection's initialize response states its exact scope, and is the authoritative answer for a given day.

This is deliberate, not multiplexing by accident. The meta-tools are what let a scoped connection answer a question this pack does not cover — via ask_pipeworx, which routes across the whole catalog — without you adding a second MCP server. There is currently no way to mount a pack endpoint without them; if the extra schemas cost you more context than the routing is worth, connect to the full gateway once rather than to several pack endpoints.

Or connect to the full Pipeworx gateway to get every pack's tools listed directly, instead of just this one's:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

Both URLs reach the same gateway and the same 1866+ data sources. The only difference is which pack's tools are listed directly; ask_pipeworx reaches all of them from either one.

No MCP client? Call it over HTTP

curl -X POST https://gateway.pipeworx.io/v1/tools/tn_dmv_driver_service_centers \
  -H 'Content-Type: application/json' \
  -d '{"service":"CDL skills test"}'

No account needed for the first calls. Inspect any tool: GET https://gateway.pipeworx.io/v1/tools/tn_dmv_driver_service_centers. Find one: POST https://gateway.pipeworx.io/v1/tools/search_packs with {"query":"..."}.

Run it from npm

@pipeworx/mcp-tn-dmv is a local stdio bridge to the Pipeworx gateway: your MCP client starts it with npx, and it forwards every call to the same https://gateway.pipeworx.io/tn-dmv/mcp endpoint shown above. It needs network access; there is no offline mode.

{
  "mcpServers": {
    "tn-dmv": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-tn-dmv"]
    }
  }
}

Without a key it calls anonymously, capped at 50 calls a day. A free account raises that to 200 a day: get a key at https://pipeworx.io/signup and add "env": { "PIPEWORX_API_KEY": "<your key>" } to the server entry. The key is sent as a Bearer token, the same way a hosted connection sends it, so calls are metered and billed exactly as they are there.

It lists only this pack's tools by default. Set PIPEWORX_META_TOOLS=1 to also list ask_pipeworx and the other gateway-wide tools.

Behind an HTTPS proxy: Node's built-in fetch does not read HTTPS_PROXY by default. Newer Node releases honour it when NODE_USE_ENV_PROXY=1 is set; check your Node version's documentation.

Using with ask_pipeworx

Instead of calling tools directly, you can ask questions in plain English — this works on the pack endpoint above as well as on the full gateway:

ask_pipeworx({ question: "your question about Tn Dmv data" })

The gateway picks the right tool and fills the arguments automatically.

More

License

MIT