africastalking-airtime-mcp
The Africa's Talking Airtime MCP server is a tool for managing airtime transactions through Africa's Talking API. It enables users to send airtime, check balances, and view transaction history, focusing on African countries. The system ensures secure transactions and stores data in a SQLite database.
Africa's Talking Airtime MCP
This project is a Model Context Protocol (MCP) server designed to manage airtime transactions using Africa's Talking API. It features tools for checking account balance, sending airtime to phone numbers, viewing and summarizing transaction history, and more. Transaction data is stored using SQLite, and the application supports African countries serviced by Africa's Talking Airtime. Key features include sending airtime, storing transactions, retrieving transaction history, and checking account balances.
Description
The Africa's Talking Airtime MCP Server integrates with the Africa's Talking Airtime API to facilitate airtime transfers. Key features include sending airtime, storing transaction details in a SQLite database, retrieving and summarizing transaction history, and checking account balance.
Tools Descriptions
The MCP provides the following tools:
- check_balance: Retrieves and displays the current airtime balance.
- load_airtime: Sends airtime to specified phone numbers and records the transaction.
- get_last_topups: Retrieves the last N airtime top-up transactions.
- sum_last_n_topups: Calculates total amount of the last N successful top-ups.
- count_topups_by_number: Counts successful top-ups to a specific number.
Example prompts
- Check Account Balance: "What is my Africa's Talking account balance?"
- Send Airtime: "Send 100 KES airtime to 0712345678."
- View Recent Top-Ups: "Show me the last 3 airtime transactions."
- Sum Recent Top-Ups: "What is the total of my last 3 top-ups?"
- Count Top-Ups by Phone Number: "How many times have I topped up 0712345678?"