Introduction

ByteMCP is a Model Context Protocol (MCP) server that enables AI assistants to help users find Bitcoin ATMs operated by ByteFederal across the United States.

What is MCP?

The Model Context Protocol is an open standard that enables AI assistants to interact with external tools and data sources. Instead of relying on static knowledge, AI assistants can query live data through MCP servers.

What ByteMCP Does

ByteMCP provides 4 tools that AI assistants can use:

Tool	Description
find_nearest_bitcoin_atm	Find ATMs near any location
get_atm_details	Get detailed info about a specific ATM
check_atm_status	Check operational status of ATMs in an area
list_atms_by_city	List all ATMs in a specific city

Why AI-Native?

Traditional ATM locators require users to:

1. Open a website or app
2. Enter their location
3. Browse results manually
4. Click through to get details

With ByteMCP, users simply ask their AI assistant:

“Find Bitcoin ATMs near me”

The AI handles the rest, returning formatted results with distances, hours, and status.

Key Features

• Real-time Data - Live ATM locations and operating hours
• Distance Calculation - Results sorted by proximity using Haversine formula
• Status Awareness - Timezone-aware open/closed status
• Flexible Deployment - Run locally or deploy as a remote server
• Claude Integration - Works with Claude Desktop and Claude.ai

Architecture

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  AI Assistant   │────▶│    ByteMCP      │────▶│    Database     │
│  (Claude, etc.) │◀────│   MCP Server    │◀────│   (ATM Data)    │
└─────────────────┘     └─────────────────┘     └─────────────────┘

ByteMCP sits between AI assistants and your ATM database, translating natural language queries into database lookups and returning formatted results.

Next Steps

• Quick Start - Get up and running in minutes
• Configuration - Set up your environment
• MCP Tools - Explore available tools