io.github.pipeworx-io/ca-dmv — MCP Server for California DMV Data

The io.github.pipeworx-io/ca-dmv Model Context Protocol (MCP) server provides California DMV information focused on vehicle and EV registrations by ZIP. It also covers field offices, relevant forms, and insurer NAIC codes, based on the provided server description.

🛠️ Key Features

Vehicle and EV registrations by ZIP
Field offices information
Forms references
Insurer NAIC codes

🚀 Use Cases

Look up DMV registration details using ZIP
Find appropriate California field office resources
Access or reference DMV forms
Identify insurer information using NAIC codes

⚡ Developer Benefits

Exposes DMV-related datasets through an MCP server interface
Organized around ZIP-based registration, offices, forms, and NAIC codes

⚠️ Limitations

No additional tools, schema details, or operational capabilities were provided in the source data.

@pipeworx/ca-dmv

California DMV data: registered vehicles and EV adoption by ZIP code, all 187 field offices with the services each performs, the official forms catalog, insurer NAIC codes, and licensed-driver counts by county. Keyless.

Why this is one state per pack

Part of the dmv category — one pack per state motor-vehicle agency. The states do not share a grain: California publishes a ZIP × make × model-year × fuel snapshot, New York a record-level file, Washington monthly transaction counts, Maryland county-months, Pennsylvania county-quarters. A single cross-state tool meant a schema where most arguments were ignored for most states and a "total" that was never comparable, so each agency gets its own tools with its own real arguments. For every DMV tool in one connection, use /mcp?vertical=dmv.

Tools

Tool	What it returns
`ca_dmv_vehicle_registrations`	Registered vehicle counts by ZIP, make, model year, fuel or duty class
`ca_dmv_ev_adoption`	Battery-electric and plug-in hybrid counts with share of the local fleet
`ca_dmv_offices`	All 187 field offices — address, per-day hours, coordinates, services performed
`ca_dmv_forms`	Official DMV forms by topic, with REG/DL form numbers and download pages
`ca_dmv_insurance_lookup`	Insurer NAIC codes by company name
`ca_dmv_driver_licenses`	Valid licences and ID cards held, by county, annually from 2008

Auth

None. Every endpoint is public California state infrastructure. The CKAN-backed tools accept an optional CKAN API key, which the public datasets do not require.

Gotchas worth knowing

Live-verified behaviours, not guesses:

Snapshots are one CKAN resource per year, 2019–2026, and the rows carry the prior December 31 as their as-of date — the "2026" file describes the fleet on 2025-12-31.
Grouping by ZIP surfaces a literal OOS bucket — out-of-state registrants, ~638k vehicles — which outranks every real ZIP. Ignore it when ranking ZIPs; the tool flags it in note.
OTHER/UNK is a real make value that absorbs small-count suppression and can outrank genuine makes in a by-make ranking.
total_vehicles appears only when it is honest. Grouping by fuel returns every category, so its sum is the true fleet total; any other grouping can be cut off by limit, and those responses carry sum_of_returned_rows plus truncated instead.
Fuel labels are specific strings (Battery Electric, Plug-in Hybrid, Hybrid Gasoline, Diesel and Diesel Hybrid, Hydrogen Fuel Cell). Plain words like "electric", "phev" or "hydrogen" are mapped for you.
Form search uses the DMV site's own relevance ranking, so a broad phrase like "title transfer" can put a vessel-title form above the vehicle one.
California publishes no wait-time feed. Only North Carolina (nc-dmv) and Oregon (or-dmv) do; ca_dmv_offices returns posted hours instead.
Lien lookup and appointment booking are unavailable: the lien endpoint requires a reCAPTCHA token and appointments run on a session-based kiosk system.

Data sources

Vehicle Fuel Type Count by Zip Code — data.ca.gov CKAN, datastore_search_sql
Driver Licenses Outstanding by County — data.ca.gov CKAN
Field office directory — dmv.ca.gov WP REST, hours and per-office service tags
Forms catalog — dmv.ca.gov WP REST
Insurance carrier NAIC lookup — https://www.dmv.ca.gov/portal/wp-json/dmv/v1/naic-lookup?s=<name>

Quick Start

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

json

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

Or connect to the full Pipeworx gateway for access to all 1392+ data sources:

json

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

Using with ask_pipeworx

Instead of calling tools directly, you can ask questions in plain English:

code

ask_pipeworx({ question: "your question about California DMV data" })

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

License

MIT

type	string	required	Entity type: "company" or "drug".
value	string	required	For company: ticker (AAPL), CIK (0000320193), or name. For drug: brand or generic name (e.g., "ozempic", "metformin").

type	string	required	Entity type: "company" or "drug".
values	array	required	For company: 2–5 tickers/CIKs (e.g., ["AAPL","MSFT"]). For drug: 2–5 names (e.g., ["ozempic","mounjaro"]).

type	string	required	Subscription type.
params	object	required	Type-specific filter. sec_8k: {ticker:"AAPL", items?:["5.02","1.01"]}. polymarket_edge: {topic:"fed", min_spread_bps?:500}. fred_series: {series_id:"UNRATE"}. patent_grant: {applicant:"Apple Inc."}. clinical_trial: {sponsor?:"Pfizer", condition?:"lung cancer", phase?:"PHASE3"} (sponsor or condition required).
delivery	object	optional	Optional delivery channels in addition to the always-on persistent feed. {email:"you@x.com"} sends a templated alert per fired event. {sms:"+15551234567"} sends an SMS per event — must match the verified phone on the caller's account (verify at https://pipeworx.io/account first; 10/day cap). {webhook:"https://..."} POSTs each event JSON to your endpoint, HMAC-signed — the response includes delivery.webhook_secret (whsec_…) ONCE; verify X-Pipeworx-Signature = sha256 HMAC of "<X-Pipeworx-Timestamp>.<raw body>". Auto-disabled after 10 consecutive failing runs.

type	string	optional	Optional — filter to one subscription type.
since	string	optional	Optional ISO timestamp — return events fired_at >= this time.
limit	number	optional	Max events to return (1-200, default 50).
unread_only	boolean	optional	Return only events where read_at is null (default false).
mark_read	boolean	optional	Flag the returned events read in the same call (default false).

type	string	required	Entity type. Only "company" supported today; person/place coming soon.
value	string	required	Ticker (e.g., "AAPL") or zero-padded CIK (e.g., "0000320193"). Names not supported — use resolve_entity first if you only have a name.

question	string	required	Your question or request in natural language. Accepts query, q, prompt, text, input as aliases.
query	string	optional	Alias for question.
q	string	optional	Alias for question.
prompt	string	optional	Alias for question.
text	string	optional	Alias for question.
input	string	optional	Alias for question.

claim	string	required	Natural-language factual claim, e.g., "Apple's FY2024 revenue was $400 billion" or "Microsoft made about $100B in profit last year".
tolerance_pct	number	optional	Max percent deviation still graded approximately_correct (0.5–50). Overrides the tolerance implied by the claim wording — set 1–2 for hallucination detection where any material error must be refuted. Default: implied by wording, capped at 5.

package	string	required	npm package name. Scoped packages (e.g. "@types/node") are accepted.
version	string	optional	Specific version to check (e.g., "18.3.1"). Defaults to the latest published version when omitted.

market	string	required	Polymarket slug ("will-bitcoin-hit-150k-by-june-30-2026"), full URL ("https://polymarket.com/event/..."), or question text ("Will Bitcoin hit $150k by June 30?")
depth	string	optional	quick = 2-3 evidence sources, thorough = full fan-out. Default thorough.
include_raw	boolean	optional	Default false. When false (recommended), FRED/FDA/GDELT/Federal-Register evidence is summarized to the few fields agents actually use — keeps responses under ~20KB. Pass true to get full upstream payloads (50KB-500KB) when you need to recompute deltas, cite specific observations, or post-process.

event	string	optional	Single-event mode (use this if you know the specific Polymarket event): event slug like "fed-decision-may-2026" or "when-will-bitcoin-hit-150k". Full Polymarket URLs also accepted.
topic	string	optional	Cross-event mode (use this if you want to scan related events across the platform): a topic or seed question like "Fed rate decision" or "Strait of Hormuz traffic returns to normal". Tool searches Polymarket for related events and checks monotonicity across them.

window	string	optional	Polymarket volume window to filter markets. Default 1wk.
limit	number	optional	Top N edges to return after ranking. Default 10, max 25.
min_edge_pp	number	optional	Minimum \|edge\| in percentage points to include (default 0.5). Edge is evaluated NET of slippage.
slippage_pp	number	optional	Assumed execution slippage in percentage points per leg (default 0.3). Subtracted from raw \|edge\| before ranking and Kelly sizing. Polymarket has zero trading fees as of 2024 but bid/ask + thin depth typically eats 20-50bp per trade. Bump for very thin partitions; drop to 0 if you have a smarter fill model.
category_filter	string	optional	Comma-separated list to restrict the output: "model_driven" (crypto_price + news_momentum), "structural_arbitrage" (partition_overround), "concentrated_longshot". Combine like "model_driven,structural_arbitrage". Default: all.
min_kelly	number	optional	Minimum half-Kelly fraction (as decimal, e.g. 0.005 = 0.5% of bankroll) to include single-leg opportunities. Default 0 (no filter). Skips opportunities that are too small to bet sensibly even if the edge is large.
min_partition_leg_kelly	number	optional	Minimum BEST per-leg half-Kelly fraction across a partition_overround opportunity's top_legs (or longshot_basket legs). Default 0 (no filter). Partition arbs always return kelly_fraction_half=0 at the parent level by design (basket trades don't compose to single-leg Kelly), so min_kelly never filters them — this knob applies to the per-leg Kelly inside top_legs instead. Use to suppress thin partitions whose individual leg edges aren't worth the per-leg slippage cost.
min_liquidity	number	optional	Tradeable-edge filter. Minimum $ liquidity on the representative market (or for partition_overround, on at least one top_leg). Default 0 (no filter). Set to 5000 to drop thin-book opportunities where executing the edge would walk the book past breakeven.
max_spread_pp	number	optional	Tradeable-edge filter. Maximum bid/ask spread in percentage points on the representative market. Default null (no filter). Set to 2 to require tight books — anything wider eats most plausible edges.

days	number	optional	Lookback in days (default 14, clamp 2-30).
window	string	optional	Which polymarket_edges window family to read snapshots for: 24hr \| 1wk \| 1mo (default 1wk).

url	string	required	Full URL of the site to summarize, e.g. "https://example.com" or a specific landing page.
max_links	number	optional	Maximum number of link entries to include (default 25, max 50).

entity	string	required	The thing to ask about. Brand/business name, product name, person, or topic. E.g. "Pipeworx", "OpenInvoice", "Acme Corp pricing".
context	string	optional	Optional: a phrase locating the entity (e.g. "Boston restaurant", "B2B SaaS"). Helps disambiguate common names.
models	array	optional	Which models to probe. Supported: "workers-ai" (free default), "anthropic" (requires _apiKey). Omit for just workers-ai.
_apiKey	string	optional	Optional Anthropic API key (sk-ant-...) — only needed if "anthropic" is in models. Passed straight through to api.anthropic.com.

entities	array	required	Array of 2-8 entities to compare (brand/business/product names). First entry treated as the "subject" for narrative; rest are competitors.
context	string	optional	Optional shared context applied to every probe (e.g. "B2B SaaS", "Boston restaurant"). Disambiguates common names.
models	array	optional	Which models to probe. Supported: "workers-ai" (free default), "anthropic" (requires _apiKey). Omit for just workers-ai.
_apiKey	string	optional	Optional Anthropic API key — only if "anthropic" is in models. Passed to api.anthropic.com per probe.

question	string	required	The research question, in natural language. Broad/multi-part is fine — decomposition is the point.
depth	string	optional	How many facets to research in parallel: quick=3 (single hop), standard=5 (default; adds a gap-recovery hop that re-angles unanswered facets + a contradictions[] scan across findings), thorough=8 (paid; adds a full iterative hop that chases leads + recovers gaps, plus the contradictions[] scan).

topic	string	optional	Pre-mapped: fed \| btc \| cpi \| gdp \| sp500 \| recession \| next_pope \| next_uk_pm \| next_israel_pm \| 2028_president
kalshi_event_ticker	string	optional	Explicit Kalshi event ticker, e.g. "KXFED-26OCT". Overrides the topic-mapped Kalshi side.
polymarket_event_slug	string	optional	Explicit Polymarket event slug, e.g. "fed-decision-in-june-825". Overrides the topic-mapped Polymarket side.

market	string	optional	Single-market mode: market slug or full polymarket.com URL.
event	string	optional	Basket mode: event slug or full polymarket.com URL — checks every leg of the partition.
side	string	optional	Single-market: buy_yes \| sell_yes \| buy_no \| sell_no (default buy_yes). Basket: sell_yes \| buy_yes (default auto — sell if partition sum > 1, buy if < 1).
size_usd	number	optional	Single-market: USD to spend (buys) or target proceeds (sells). Basket: settlement notional — shares per leg, each paying $1 at resolution. Default 1000, clamp 10–1,000,000.

type	string	required	bug = something broke or returned wrong data. feature = a new tool or capability you wish existed. data_gap = data Pipeworx does not currently expose. praise = positive note. other = anything else.
message	string	required	Your feedback in plain text. Be specific (which tool, what error, what data was missing). 1-2 sentences typical, 2000 chars max.
context	object	optional	Optional structured context: which tool, pack, or vertical this relates to.

key	string	required	Memory key (e.g., "subject_property", "target_ticker", "user_preference")
value	string	required	Value to store (any text — findings, addresses, preferences, notes)

zip	string	optional	Five-digit California ZIP code, e.g. "90210".
fuel_type	string	optional	Fuel/drivetrain; plain words are mapped to California's labels, e.g. "electric", "diesel", "gas", "hybrid", "plug-in hybrid", "hydrogen".
make	string	optional	Vehicle make, matched as a substring, e.g. "TESLA", "FORD".
model_year	string	optional	Four-digit model year, e.g. "2024".
duty	string	optional	Vehicle weight class: "Light", "Heavy" or "Unk".
year	string	optional	Snapshot year, 2019–2026. Defaults to 2026 (the most recent).
group_by	string	optional	Breakdown dimension: fuel (default), zip, make, model_year, duty.
limit	number \| string	optional	Max rows to return (default 25, max 200).

zip	string	optional	Five-digit California ZIP code, e.g. "94002".
make	string	optional	Vehicle make, matched as a substring, e.g. "TESLA", "RIVIAN".
model_year	string	optional	Four-digit model year, e.g. "2025".
year	string	optional	Snapshot year, 2019–2026. Defaults to 2026.
group_by	string	optional	fuel (default) returns the whole mix plus EV share; zip, make or model_year return plug-in counts by that dimension.
limit	number \| string	optional	Max rows to return (default 25, max 200).

city	string	optional	City name, matched as a substring, e.g. "Sacramento", "San Jose".
zip	string	optional	Five-digit ZIP code, e.g. "95814".
name	string	optional	Office-name substring, e.g. "Express", "Commercial".
service	string	optional	Require a service, e.g. "dl retest", "duplicate title", "id cards", "self service terminals".
limit	number \| string	optional	Max offices to return (default 50, max 200).

county	string	optional	County name, matched as a substring, e.g. "Los Angeles", "Alameda".
year	string	optional	Four-digit year between 2008 and 2024, e.g. "2024". Defaults to the most recent published.
limit	number \| string	optional	Max counties to return (default 30, max 60).

io.github.pipeworx-io/ca-dmv — MCP Server for California DMV Data

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

ask_pipeworx

ask_pipeworx_beta

ask_pipeworx_grounded

search_within

deep_research

discover_tools

resolve_entity

compare_entities

subscribe

unsubscribe

list_subscriptions

recent_alerts

entity_profile

recent_changes

validate_claim

scan_dependency

bet_research

polymarket_arbitrage

polymarket_edges

polymarket_kalshi_spread

polymarket_fill_risk

polymarket_edge_tracker

pipeworx_trending

suggest_questions

generate_llms_txt

ai_visibility_check

scan_competitor_ai_presence

pipeworx_feedback

remember

recall

forget

ca_dmv_vehicle_registrations

ca_dmv_ev_adoption

ca_dmv_offices

ca_dmv_forms

ca_dmv_insurance_lookup

ca_dmv_driver_licenses