check_atm_status
The check_atm_status tool provides a summary of ATM operational status within a specified area.
Parameters
Section titled “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
Section titled “Example Usage”"How many ATMs are open in Dallas right now?"Tool call:
{ "name": "check_atm_status", "arguments": { "location": "Dallas, TX", "radius": 15 }}Response
Section titled “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
Section titled “Response Fields”Summary Object
Section titled “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
Section titled “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
Section titled “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
Section titled “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
Section titled “Timezone Handling”Status calculations account for:
- ATM’s physical location (state-based timezone)
- Daylight saving time adjustments
- Day-of-week variations in hours
- 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