CrashStory MCP

Search for personal injury attorneys in Colorado. Filter by city, county, specialty, rating, and verification status. Returns attorney profiles plus the canonical slug to use with profile, review, and comparison tools.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search by name or firm name"
    },
    "city": {
      "type": "string",
      "description": "City name (e.g. \"Denver\", \"Colorado Springs\")"
    },
    "county": {
      "type": "string",
      "description": "Service county name"
    },
    "specialty": {
      "type": "string",
      "description": "Specialty filter (e.g. \"Car Accident\", \"Wrongful Death\")"
    },
    "min_rating": {
      "type": "number",
      "minimum": 1,
      "maximum": 5,
      "description": "Minimum average rating (1.0-5.0)"
    },
    "verified": {
      "type": "boolean",
      "description": "Only return verified attorneys"
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "relevance",
        "rating",
        "reviews",
        "experience"
      ],
      "default": "relevance",
      "description": "Sort order"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20,
      "description": "Max results (1-50)"
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "default": 1,
      "description": "Page number"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get a detailed attorney profile by slug. Returns full bio, practice areas, reviews, credentials, office location, and AI-analyzed intelligence data when available.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "Canonical attorney slug from search_attorneys or list_attorney_cities (e.g. \"levine-law-llc-denver\")"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Find personal injury attorneys near a geographic location. Uses Haversine distance calculation. Returns attorneys sorted by distance with contact info and ratings.

{
  "type": "object",
  "properties": {
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude of the location"
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude of the location"
    },
    "radius_miles": {
      "type": "number",
      "minimum": 1,
      "maximum": 100,
      "default": 10,
      "description": "Search radius in miles (1-100, default 10)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10,
      "description": "Max results (1-50, default 10)"
    }
  },
  "required": [
    "latitude",
    "longitude"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List all Colorado cities that have active personal injury attorneys, with the count of attorneys in each city. Useful for discovering which cities have coverage.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get the top-ranked personal injury attorneys in Colorado. Returns attorneys ranked by a composite score considering ratings, reviews, experience, and case outcomes.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20,
      "description": "Number of attorneys to return (1-50, default 20)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Compare 2-4 attorney profiles side-by-side. Use canonical slugs from search_attorneys. Returns key comparison metrics including ratings, reviews, specialties, practice areas, and known experience fields.

{
  "type": "object",
  "properties": {
    "slugs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 2,
      "maxItems": 4,
      "description": "Array of 2-4 attorney slugs to compare"
    }
  },
  "required": [
    "slugs"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get paginated client reviews for a specific attorney. Includes review text, rating, reviewer name, date, and rating distribution breakdown.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "Attorney slug identifier"
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "default": 1,
      "description": "Page number"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20,
      "description": "Reviews per page (1-50, default 20)"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get review velocity analytics for a specific attorney. Includes review frequency trends, freshness score, momentum indicators, composite score, city percentile rank, and month-over-month time series.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "Canonical attorney slug from search_attorneys (e.g. \"levine-law-llc-denver\")"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get the review-based leaderboard for attorneys in a specific Colorado city. Ranks attorneys by composite review metrics including velocity, freshness, momentum, and rating.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "minLength": 1,
      "description": "City name (e.g. \"Denver\", \"Boulder\", \"Colorado Springs\")"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10,
      "description": "Number of attorneys to return (1-50, default 10)"
    }
  },
  "required": [
    "city"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get AI-analyzed review intelligence for a law firm. Returns plain-language praise and complaint summaries, 12 consumer pain point dimensions, case type distribution, trust signals, response quality, and highlight reviews.

{
  "type": "object",
  "properties": {
    "firm_slug": {
      "type": "string",
      "minLength": 1,
      "description": "Canonical firm slug from search_attorneys (e.g. \"levine-law-llc-denver\")"
    }
  },
  "required": [
    "firm_slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Compare AI-analyzed review intelligence across 2-5 law firms. Returns side-by-side pain point dimensions, sentiment, trust signals, response quality, and case type distributions for competitive analysis.

{
  "type": "object",
  "properties": {
    "firm_slugs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 2,
      "maxItems": 5,
      "description": "Array of 2-5 firm slugs to compare"
    }
  },
  "required": [
    "firm_slugs"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search a law firm's detailed reviews for the most relevant matches to a specific need, case type, injury, sentiment, or pain point. Use this when someone asks for reviews about communication, wrongful death, motorcycle crashes, fees, settlement clarity, or similar client concerns.

{
  "type": "object",
  "properties": {
    "firm_slug": {
      "type": "string",
      "minLength": 1,
      "description": "Canonical firm slug from search_attorneys or get_review_intelligence"
    },
    "need": {
      "type": "string",
      "description": "Natural-language client need or concern, e.g. \"good communication\" or \"fast settlement\""
    },
    "case_type": {
      "type": "string",
      "description": "Case type, e.g. \"wrongful death\", \"motorcycle\", \"truck accident\""
    },
    "injury": {
      "type": "string",
      "description": "Injury or harm keyword, e.g. \"back injury\", \"death\", \"concussion\""
    },
    "dimension": {
      "type": "string",
      "description": "Specific review-intelligence dimension, e.g. \"Communication\" or \"FeeTransparency\""
    },
    "sentiment": {
      "type": "string",
      "enum": [
        "any",
        "positive",
        "negative",
        "mixed"
      ],
      "default": "any",
      "description": "Filter toward praise, complaints, or mixed reviews"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 10,
      "description": "Max ranked reviews to return"
    }
  },
  "required": [
    "firm_slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search Colorado crash records by location, date range, crash type, and severity. Database contains 500,000+ CDOT crash records. Returns key fields including location, date, severity, injuries, fatalities, and contributing factors.

{
  "type": "object",
  "properties": {
    "location": {
      "type": "string",
      "description": "City, county, or street name (case-insensitive partial match)"
    },
    "date_from": {
      "type": "string",
      "description": "Start date (ISO 8601, e.g. \"2024-01-01\")"
    },
    "date_to": {
      "type": "string",
      "description": "End date (ISO 8601, e.g. \"2024-12-31\")"
    },
    "crash_type": {
      "type": "string",
      "description": "Crash type: BROADSIDE, REAR_END, SIDESWIPE_SAME_DIRECTION, SIDESWIPE_OPPOSITE_DIRECTION, HEAD_ON, ROLLOVER, FIXED_OBJECT, ANIMAL, PEDESTRIAN, BICYCLE, MOTORCYCLE, OTHER"
    },
    "severity": {
      "type": "string",
      "description": "Severity: FATAL, SERIOUS_INJURY, MINOR_INJURY, POSSIBLE_INJURY, PROPERTY_DAMAGE_ONLY"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 20,
      "description": "Max results (1-100, default 20)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get full details of a specific Colorado crash by its CUID (Crash Unique Identifier). Returns complete crash record including all vehicles involved, injuries, contributing factors, road conditions, weather, and narrative.

{
  "type": "object",
  "properties": {
    "cuid": {
      "type": "string",
      "minLength": 1,
      "description": "CDOT Crash Unique ID (e.g. \"2024-001234\")"
    }
  },
  "required": [
    "cuid"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get crash records near a specific attorney's office location. This tool is attorney-centered, not a raw lat/lng search. Use a canonical attorney slug from search_attorneys, then this tool will search around that office address.

{
  "type": "object",
  "properties": {
    "attorney_slug": {
      "type": "string",
      "minLength": 1,
      "description": "Canonical attorney slug from search_attorneys, used as the center point"
    },
    "radius_km": {
      "type": "number",
      "minimum": 0.5,
      "maximum": 50,
      "default": 3,
      "description": "Search radius in km (0.5-50, default 3)"
    },
    "months": {
      "type": "integer",
      "minimum": 1,
      "maximum": 120,
      "default": 12,
      "description": "Look-back period in months (1-120, default 12)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "default": 50,
      "description": "Max results (1-200, default 50)"
    },
    "sort": {
      "type": "string",
      "enum": [
        "distance",
        "date"
      ],
      "default": "distance",
      "description": "Sort by distance or date"
    }
  },
  "required": [
    "attorney_slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List CrashStory research datasets that can be queried through the MCP server, including gas-price analysis datasets and their available data views.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get the structured summary/report for a CrashStory research dataset. Use this before row-level querying to understand coverage, methodology, findings, and limitations.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "enum": [
        "gas-prices-vs-crashes",
        "gas-prices-vs-fatalities-national"
      ],
      "description": "Dataset slug. Options: gas-prices-vs-crashes, gas-prices-vs-fatalities-national."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Query rows from CrashStory research datasets. Supports the gas-price analysis datasets with optional state, year, and month filters so agents can perform their own follow-on analysis.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "enum": [
        "gas-prices-vs-crashes",
        "gas-prices-vs-fatalities-national"
      ],
      "description": "Dataset slug. Options: gas-prices-vs-crashes, gas-prices-vs-fatalities-national."
    },
    "dataset": {
      "type": "string",
      "enum": [
        "analysis_window",
        "full_window",
        "state_year_panel",
        "state_year_yoy",
        "state_profiles",
        "national_summary"
      ],
      "description": "Data view. Colorado options: analysis_window, full_window. National options: state_year_panel, state_year_yoy, state_profiles, national_summary."
    },
    "state": {
      "type": "string",
      "description": "Optional two-letter state abbreviation filter, mainly for national datasets."
    },
    "year_from": {
      "type": "integer",
      "description": "Optional minimum year filter."
    },
    "year_to": {
      "type": "integer",
      "description": "Optional maximum year filter."
    },
    "month_from": {
      "type": "string",
      "description": "Optional minimum month filter in YYYY-MM format, mainly for the Colorado monthly dataset."
    },
    "month_to": {
      "type": "string",
      "description": "Optional maximum month filter in YYYY-MM format, mainly for the Colorado monthly dataset."
    },
    "sort": {
      "type": "string",
      "description": "Optional sort field."
    },
    "order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "default": "desc",
      "description": "Sort order (default desc)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000,
      "default": 50,
      "description": "Maximum rows to return."
    }
  },
  "required": [
    "slug",
    "dataset"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}