Africastalking Airtime MCP Server

This project implements a **Model Context Protocol (MCP) server** that enables seamless interaction with the **Africa's Talking API** for

Local serverstdioPython

What is the Africastalking Airtime MCP Server?

This project implements a Model Context Protocol (MCP) server that enables seamless interaction with the Africa's Talking API for airtime-related operations. It provides a suite of tools for checking account balances, sending airtime, viewing transaction history, and summarizing top-up.

What Africastalking Airtime MCP does

This project implements a Model Context Protocol (MCP) server that enables seamless interaction with the Africa's Talking API for airtime-related operations. It provides a suite of tools for checking account balances, sending airtime, viewing transaction history, and summarizing top-up data. The server uses an SQLite database for persistent storage and includes logic for formatting phone numbers for various African countries.

Key capabilities

  • Check Balance — Instantly retrieve the current airtime balance of your Africa's Talking account
  • Send Airtime — Load airtime to any phone number in supported countries
  • Transaction Logging — Automatically save every transaction to a local SQLite database
  • Transaction History — View a list of the most recent top-up transactions
  • Summarize Top-ups — Calculate the total amount of the last 'n' top-ups
  • Count Top-ups — Count the number of transactions for a specific phone number
  • Phone Number Formatting — Automatically formats phone numbers to include the correct country code

Requirements

  1. Python 3.10 or higher: Ensure you have a modern version of Python installed. 2. uv Package Manager: This project uses uv for dependency management. Install it by running:

Practical notes

  • Maintained by nasoma, written in Python.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
check_balance
load_airtime
get_last_topups
sum_last_n_topups
count_topups_by_number

Configuration

  1. Python 3.10 or higher: Ensure you have a modern version of Python installed. 2. uv Package Manager: This project uses uv for dependency management. Install it by running:

Example prompts to try

  • “Use Africastalking Airtime MCP to Prerequisites.”
  • “Use Africastalking Airtime MCP to check balance.”
  • “Use Africastalking Airtime MCP to load airtime.”

Frequently asked questions

This project implements a **Model Context Protocol (MCP) server** that enables seamless interaction with the **Africa's Talking API** for airtime-related Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.