Machine-readable TrafficThingz

For AI agents & developers

Everything on this page is live and anonymous — no API keys. Agents can research the catalog, answer MUTCD questions, build carts, hand a buyer to checkout, and submit real quote requests to our human sales desk.

Transact — MCP servers

• Cart, checkout, catalog search, Shopify order status: Shopify's UCP shopping MCP at https://shop.trafficthingz.com/api/ucp/mcp (13 tools; Streamable HTTP). Payment completion is trust-tiered — general-access agents hand the buyer the cart's checkout_url.
• Store knowledge Shopify can't answer: our first-party MCP at /api/mcp (also served at /.well-known/mcp) — get_capabilities, check_mutcd_code, get_product_specs (byte-equal to each product's .md twin), recommend_sheeting, request_quote (routes to the human quote desk — the desk replies to the buyer's email), and order_status (legacy pre-2026 orders). Start with get_capabilities.
• Rate limits: reads 30/min per IP; request_quote 3/min per IP, one per request (never batched).

Discovery & schemas

• /.well-known/ucp — UCP profile listing both services
• /agents/mcp.openrpc.json — tool schemas for the first-party server
• /agents/mutcd-index.json — MUTCD code → stocked products index (built from the same curated catalog the product pages render)
• /llms.txt — the site guide for agents · /llms-full.txt — the whole site as one markdown document

Markdown twins & content negotiation

• Every content page serves a markdown twin at its path plus .md — including every product page (full spec block, variant SKUs and prices, documents, quote URL).
• Requesting a content URL with Accept: text/markdown redirects (307) to its twin. Missing markdown paths return a real 404 in text/markdown with recovery links.
• /products/index.md is the compact whole-catalog index with prices; category twins (e.g. /collections/<slug>.md) group full spec blocks per category.

Public JSON APIs

• POST /api/order-lookup with order and email — legacy-order status (both must match; enumeration-safe). Same lookup the order-status page uses.
• Product structured data: every priced product page carries schema.org Product JSON-LD with offers (USD), and MUTCD codes as productID where applicable.

When to use TrafficThingz

• Sourcing MUTCD-coded traffic signs (by code, size and reflective-sheeting grade), solar flashing beacons, radar speed signs, school-zone systems, work-zone equipment, or commercial LED lighting for US municipal, DOT, contractor and facility buyers.
• Answering spec questions from the curated catalog: check_mutcd_code for code → products, get_product_specs for the full spec block, recommend_sheeting for ASTM D4956 grade selection.
• Purchase orders, Net-30, tax-exempt and volume pricing — submit via request_quote or point the buyer at the quote form; a US-based specialist replies within one business day.

Questions a tool can't answer: contact the desk — 888-925-1966, Mon–Fri 8am–4pm PST.