pestsentinel_list_zones
List all geographic zones covered by Pest Sentinel's weekly risk scoring.
Pest Sentinel currently covers 500+ zones across 12 US states and 7 Canadian provinces. Each zone is a neighborhood or district within a major city.
Args:
- country (string, optional): Filter by country code — 'US' or 'CA'
- province (string, optional): Filter by state/province code (e.g., 'TX', 'FL', 'ON', 'QC')
- region (string, optional): Filter by city/region name (e.g., 'Chicago', 'Toronto')
- limit (number): Max results to return, 1–200 (default: 50)
- offset (number): Pagination offset (default: 0)
- response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns:
List of zones with id, name, region, province, country, and coordinates.
Examples:
- "Show me all zones in Texas" → province='TX'
- "What zones are covered in Toronto?" → region='Toronto'
- "List all US zones" → country='US'
pestsentinel_search_zones
Search for zones by name or city to find the zone ID needed for risk score queries.
Use this tool when you know a city or neighborhood name and need to find the matching zone ID before calling pestsentinel_get_zone_scores or pestsentinel_get_zone_history.
Args:
- query (string): City, neighborhood, or zone name to search (min 2 characters)
- response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns:
Matching zones with their IDs, regions, and locations.
Examples:
- "Find zones in Nashville" → query='Nashville'
- "Search for Brooklyn zones" → query='Brooklyn'
- "Is Columbus covered?" → query='Columbus'
pestsentinel_get_zone_scores
Get the current weekly pest risk scores for a specific zone.
Returns scores for all 15 pest types (or a single pest type if specified) for the most recent week. Scores range from 0–100. Trend indicates direction vs. prior week.
Pest types: rodents, mosquitoes, cockroaches, bedbugs, carpenter_ants, raccoons, squirrels, skunks, bats, groundhogs, opossums, wasps, termites, fire_ants, scorpions
Args:
- zone_id (string): The UUID of the zone (use pestsentinel_search_zones to find it)
- pest_type (string, optional): Filter to a single pest type
- response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns:
Current risk scores with trend, confidence, and risk drivers for the zone.
Examples:
- "What's the rodent risk in downtown Chicago?" → first search for zone, then get scores with pest_type='rodents'
- "Show all pest scores for Miami Beach zone" → zone_id='<uuid>'
pestsentinel_get_rising_zones
Get zones with rising pest pressure this week — the most actionable intelligence for pest control operators.
Returns zones where the current week's score is trending upward, sorted by score descending. Use this to find where pest activity is accelerating before it peaks.
Args:
- pest_type (string, optional): Filter to a specific pest type
- country (string, optional): Filter by country code 'US' or 'CA'
- province (string, optional): Filter by state/province (e.g. 'TX', 'FL')
- min_score (number, optional): Minimum score threshold 0–100 (default: 40)
- limit (number): Max results, 1–100 (default: 20)
- response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns:
Zones with rising trend, sorted by risk score, with zone name and location.
Examples:
- "Where is mosquito activity rising this week?" → pest_type='mosquitoes'
- "Rising rodent pressure in Florida?" → pest_type='rodents', province='FL'
- "What zones should I target this week?" → no filters
pestsentinel_get_top_zones
Get the highest-scoring pest risk zones this week across any region or pest type.
Use this to identify the most active pest hotspots nationally or regionally. Useful for operators expanding territory, PE firms evaluating markets, or anyone asking "where is pest pressure highest right now?"
Args:
- pest_type (string, optional): Filter to one pest type
- country (string, optional): 'US' or 'CA'
- province (string, optional): State/province code e.g. 'TX', 'CA', 'FL'
- limit (number): Max results 1–50 (default: 10)
- response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns:
Top-scoring zones with pest type, score, trend, and location.
Examples:
- "Where is termite risk highest in the US?" → pest_type='termites', country='US'
- "Top 10 highest pest pressure zones this week" → no filters
- "Highest rodent risk in Texas?" → pest_type='rodents', province='TX'
pestsentinel_get_zone_history
Get historical weekly risk scores for a zone to see how pest pressure has changed over time.
Returns scores week-by-week going back up to 12 weeks. Useful for identifying seasonal patterns, long-term trends, or evaluating territory before expansion.
Args:
- zone_id (string): The UUID of the zone
- pest_type (string, optional): Filter to a single pest type
- weeks (number): Number of weeks of history to return, 1–12 (default: 6)
- response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns:
Weekly scores with trend and confidence for the requested period.
Examples:
- "How has mosquito pressure changed in Tampa over the last 6 weeks?" → zone_id + pest_type='mosquitoes'
- "Show termite history for Houston zone" → zone_id + pest_type='termites'
pestsentinel_get_regional_summary
Get a high-level pest risk summary for an entire state, province, or city — aggregated across all zones in that region.
Returns average and peak scores per pest type, with rising/falling/stable zone counts. Ideal for market analysis, territory planning, and understanding which pests are dominant in a region.
Args:
- province (string, optional): State/province code e.g. 'TX', 'FL', 'ON'
- region (string, optional): City/region name e.g. 'Chicago', 'Miami', 'Toronto'
- country (string, optional): 'US' or 'CA'
- response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns:
Per-pest aggregated stats: avg score, peak score, zone count, rising/falling breakdown.
Examples:
- "What's the pest outlook for Florida this week?" → province='FL'
- "Summarize pest risk in Chicago" → region='Chicago'
- "Compare pest types across all US zones" → country='US'
pestsentinel_list_pest_types
List all 15 pest types tracked by Pest Sentinel with descriptions of what drives their risk scores.
Use this tool to discover available pest types before calling other tools that require a pest_type parameter.
Args:
- response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns:
All 15 pest types with descriptions of their primary risk drivers.
pestsentinel_get_coverage
Get a summary of Pest Sentinel's current data coverage — how many zones, states, countries, pest types, and weeks of history are available.
Use this tool to understand what's available before making other queries. Returns current platform stats.
Args:
- response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns:
Coverage stats: zone count, state/province breakdown, latest week scored, total risk scores.