list_atms_by_city

The list_atms_by_city tool returns all ByteFederal ATMs in a specified city and state.

Parameters

Parameter	Type	Required	Description
state	string	Yes	State code (e.g., “FL”, “TX”, “CA”)
city	string	Yes	City name

Example Usage

"List all Bitcoin ATMs in Austin, Texas"

Tool call:

{
  "name": "list_atms_by_city",
  "arguments": {
    "state": "TX",
    "city": "Austin"
  }
}

Response

{
  "success": true,
  "data": {
    "city": "Austin",
    "state": "TX",
    "count": 8,
    "locations": [
      {
        "id": 201,
        "name": "7-Eleven - Congress Ave",
        "address": "100 Congress Ave",
        "status": "open",
        "hours": "6:00 AM - 11:00 PM",
        "coordinates": {
          "lat": 30.2672,
          "lon": -97.7431
        }
      },
      {
        "id": 202,
        "name": "Shell - Lamar Blvd",
        "address": "2500 S Lamar Blvd",
        "status": "open",
        "hours": "24/7",
        "coordinates": {
          "lat": 30.2500,
          "lon": -97.7700
        }
      }
    ]
  }
}

Response Fields

Field	Type	Description
city	string	Queried city name
state	string	Queried state code
count	number	Total ATMs found
locations	array	List of ATM objects

Location Object

Field	Type	Description
id	number	Unique ATM identifier
name	string	Location/business name
address	string	Street address
status	string	”open” or “closed”
hours	string	Today’s operating hours
coordinates	object	Lat/lon coordinates

Natural Language Examples

User Says	Tool Parameters
”ATMs in Miami, Florida”	state: "FL", city: "Miami"
”Bitcoin ATMs in Los Angeles”	state: "CA", city: "Los Angeles"
”List Houston ATMs”	state: "TX", city: "Houston"
”All ATMs in NYC”	state: "NY", city: "New York"

State Codes

Use standard 2-letter state codes:

State	Code	State	Code
Florida	FL	Texas	TX
California	CA	New York	NY
Georgia	GA	Arizona	AZ
Colorado	CO	Nevada	NV

Empty Results

If no ATMs are found:

{
  "success": true,
  "data": {
    "city": "SmallTown",
    "state": "MT",
    "count": 0,
    "locations": [],
    "message": "No ByteFederal ATMs found in SmallTown, MT"
  }
}

Use Cases

• City Overview - See all ATM locations in a city
• Planning - Identify ATMs before visiting an area
• Coverage Analysis - Check ByteFederal presence in a market
• Comparison - Compare availability across cities

Notes

• Results are not sorted by distance (no reference point)
• All ATMs in the city are returned regardless of status
• City names are case-insensitive
• Partial city names may not match (use full city name)