MCP Tools Overview

ByteMCP provides 4 MCP tools that AI assistants can use to query Bitcoin ATM locations.

Available Tools

Tool	Purpose	Key Parameters
find_nearest_bitcoin_atm	Find ATMs near a location	location, limit, maxDistance
get_atm_details	Get details for a specific ATM	atmId
check_atm_status	Check ATM status in an area	location, radius
list_atms_by_city	List all ATMs in a city	state, city

How Tools Work

When an AI assistant receives a user query like “Find Bitcoin ATMs near Miami”, it:

1. Recognizes Intent - Understands the user wants ATM locations
2. Selects Tool - Chooses find_nearest_bitcoin_atm
3. Extracts Parameters - Identifies “Miami” as the location
4. Calls ByteMCP - Sends the tool request via MCP
5. Formats Response - Presents results in a readable format

Tool Response Format

All tools return structured data that AI assistants format for display:

{
  "success": true,
  "data": {
    "locations": [...],
    "count": 5,
    "searchArea": "Miami, FL"
  }
}

Common Parameters

Location Input

Tools accept locations in multiple formats:

• Address: “123 Main St, Miami, FL”
• City/State: “Miami, FL” or “Miami, Florida”
• ZIP Code: “33101”
• Coordinates: lat: 25.7617, lon: -80.1918

Distance Units

All distances are returned in miles.

Limits

• limit: Maximum results (1-50, default 10)
• maxDistance: Maximum search radius (1-100 miles, default 25)

Status Information

Tools include real-time status:

• Open/Closed - Based on current time in ATM’s timezone
• Operating Hours - Full schedule by day of week
• Next Opening - When closed ATMs will reopen

Example Queries

Here are example natural language queries and which tools handle them:

Query	Tool Used
”Find Bitcoin ATMs near me”	find_nearest_bitcoin_atm
”What are the hours for ATM #456?”	get_atm_details
”How many ATMs are open in Dallas?”	check_atm_status
”List all ATMs in Austin, Texas”	list_atms_by_city

Next Steps

Explore each tool in detail:

• Find Nearest ATM
• Get ATM Details
• Check ATM Status
• List ATMs by City