CRASH LENS — Traffic Safety Analysis Tool

A browser-based crash analysis system for transportation agencies. Supports multi-state crash data analysis with EPDO scoring, hotspot identification, signal warrant evaluation, and grant eligibility assessment.

---

CrashLens MCP Server (for Claude Desktop)

The CrashLens MCP (Model Context Protocol) server lets you use Claude Desktop to query and analyze your crash data using natural language. It supports all 50 US states, any jurisdiction, and multiple road type filters.

Prerequisites

• Node.js v18 or later
• Claude Desktop installed
• An active CrashLens subscription

Quick Setup (4 Steps)

Step 1: Get Your API Key

Log into CrashLens → click your profile icon (top right) → My Account → API Keys tab → Generate API Key → Copy the key.

Step 2: Open Claude Desktop Config

Open Claude Desktop → Settings (gear icon) → Developer → Edit Config

This opens the claude_desktop_config.json file.

Step 3: Add the CrashLens MCP Server

Paste the following into your config. Replace the placeholder values with your API key, state, and jurisdiction:

{
  "mcpServers": {
    "crashlens": {
      "command": "npx",
      "args": ["-y", "@crashlens_maq/mcp"],
      "env": {
        "CRASHLENS_STATE": "YOUR_STATE",
        "CRASHLENS_JURISDICTION": "YOUR_JURISDICTION",
        "CRASHLENS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Tip: The API Keys tab in the web app shows a ready-to-copy config snippet with your key and jurisdiction pre-filled.

If you already have other MCP servers in your config, just add the "crashlens" entry inside the existing "mcpServers" object.

Step 4: Restart Claude Desktop

Quit and reopen Claude Desktop. On first launch, the MCP server will automatically download your jurisdiction's crash data (~30 seconds one-time download). You'll see a hammer icon when tools are ready.

Configuration Options

Example Configurations

Henrico County, Virginia (all roads):

{
  "mcpServers": {
    "crashlens": {
      "command": "npx",
      "args": ["-y", "@crashlens_maq/mcp"],
      "env": {
        "CRASHLENS_STATE": "virginia",
        "CRASHLENS_JURISDICTION": "henrico",
        "CRASHLENS_API_KEY": "clmcp_your_key_here"
      }
    }
  }
}

Douglas County, Colorado (county roads only):

{
  "mcpServers": {
    "crashlens": {
      "command": "npx",
      "args": ["-y", "@crashlens_maq/mcp"],
      "env": {
        "CRASHLENS_STATE": "colorado",
        "CRASHLENS_JURISDICTION": "douglas",
        "CRASHLENS_API_KEY": "clmcp_your_key_here",
        "CRASHLENS_ROAD_TYPE": "county_roads"
      }
    }
  }
}

Maricopa County, Arizona (no interstate):

{
  "mcpServers": {
    "crashlens": {
      "command": "npx",
      "args": ["-y", "@crashlens_maq/mcp"],
      "env": {
        "CRASHLENS_STATE": "arizona",
        "CRASHLENS_JURISDICTION": "maricopa",
        "CRASHLENS_API_KEY": "clmcp_your_key_here",
        "CRASHLENS_ROAD_TYPE": "no_interstate"
      }
    }
  }
}

Finding Your State and Jurisdiction Values

Use the same state and jurisdiction names shown in the CrashLens web app when you upload or select your data. Format: lowercase, replace spaces with underscores.

Road Type Options

What You Can Ask Claude

Once connected, ask Claude natural language questions about your crash data:

• "What are the top 10 crash hotspot intersections?"
• "Show me the crash profile for Broad Street"
• "Which locations have the most fatal and serious injury crashes?"
• "Are there any over-represented crash patterns on Route 1?"
• "Calculate EPDO for 2 fatal, 5 serious injury, 10 minor, 20 possible, and 100 PDO crashes"
• "Evaluate signal warrant for an intersection with 500 major and 150 minor volume"
• "Score grant eligibility for Highway 85"
• "Search for HSIP grants"

Available MCP Tools (22)

Crash Data (5)

Analysis (4)

CMF / Countermeasures (3)

Safety (3)

Infrastructure & Discovery (7)

Data Caching

• Crash data is downloaded once and cached locally at ~/.crashlens/{state}/{jurisdiction}/
• Subsequent launches use cached data (instant startup)
• To force a fresh download, delete the cache folder:
  • Windows: rmdir /s %USERPROFILE%\.crashlens
  • macOS/Linux: rm -rf ~/.crashlens

Troubleshooting

---

Copyright and License

Copyright 2025 MURAD Al Qurishee. All Rights Reserved.

This software is proprietary and is NOT available for reuse, modification, or distribution without explicit written permission from MURAD Al Qurishee.

Restrictions

• This software may NOT be copied, reproduced, or duplicated in any form.
• This software may NOT be modified, altered, or adapted.
• This software may NOT be distributed, shared, or transferred to any third party.
• This software may NOT be used for commercial purposes without authorization.

Contact

For permissions, licensing inquiries, or questions regarding this software, please contact:

MURAD Al Qurishee Email: support@aicreatesai.com