check_atm_status

The check_atm_status tool provides a summary of ATM operational status within a specified area.

Parameters

Parameter	Type	Required	Default	Description
location	string	No*	-	Address, city/state, or ZIP code
lat	number	No*	-	Latitude coordinate
lon	number	No*	-	Longitude coordinate
radius	number	No	10	Search radius in miles

*Either location OR lat/lon coordinates are required.

Example Usage

"How many ATMs are open in Dallas right now?"

Tool call:

{
  "name": "check_atm_status",
  "arguments": {
    "location": "Dallas, TX",
    "radius": 15
  }
}

Response

{
  "success": true,
  "data": {
    "summary": {
      "total": 12,
      "open": 9,
      "closed": 3,
      "openPercentage": 75
    },
    "searchArea": "Dallas, TX",
    "radius": 15,
    "currentTime": "2024-03-15T14:30:00-05:00",
    "openLocations": [
      {
        "id": 101,
        "name": "7-Eleven - Main St",
        "distance": 0.5,
        "closesAt": "11:00 PM"
      },
      {
        "id": 102,
        "name": "Chevron - Oak Lawn",
        "distance": 1.2,
        "closesAt": "10:00 PM"
      }
    ],
    "closedLocations": [
      {
        "id": 103,
        "name": "Shell - Commerce St",
        "distance": 2.1,
        "opensAt": "6:00 AM tomorrow"
      }
    ]
  }
}

Response Fields

Summary Object

Field	Type	Description
total	number	Total ATMs in search area
open	number	Currently open ATMs
closed	number	Currently closed ATMs
openPercentage	number	Percentage of ATMs open

Location Objects

Field	Type	Description
id	number	ATM identifier
name	string	Location name
distance	number	Distance from search center
closesAt	string	When the ATM closes (for open)
opensAt	string	When the ATM opens (for closed)

Natural Language Examples

User Says	Interpreted As
”Are there open ATMs near me?”	Status check at user’s location
”ATM availability in Chicago”	Status check for Chicago area
”How many ATMs are operating in Miami?”	Status summary for Miami
”Which ATMs are closed right now in Austin?”	Focus on closed ATMs

Use Cases

• Plan Visits - Check availability before traveling
• Late Night - Find ATMs open late
• Area Coverage - Assess ATM availability in a region
• Operations - Monitor ATM network status

Timezone Handling

Status calculations account for:

• ATM’s physical location (state-based timezone)
• Daylight saving time adjustments
• Day-of-week variations in hours

Notes

• Results include both open and closed ATMs
• Times are displayed in the ATM’s local timezone
• “24/7” locations are marked as always open
• Search radius is limited to 100 miles maximum