Africa's Talking Airtime MCP

What is Africa's Talking Airtime MCP?

A Model Context Protocol (MCP) server for managing airtime transactions via the Africa's Talking API. It provides tools to check balance, send airtime, view recent top-ups, sum amounts, and count top-ups by phone number, storing data in SQLite. Designed for developers integrating airtime management into AI clients like Claude Desktop or Goose.

How to use Africa's Talking Airtime MCP?

Install Python 3.10+, uv, clone the repository, and run uv sync. Configure with your AI client by setting environment variables username, api_key, country, and currency_code. Invoke the server through the client’s MCP configuration (e.g., for Claude Desktop add a JSON entry with command, args, and env). Use the provided tools via natural language prompts.

Key features of Africa's Talking Airtime MCP?

• Sending airtime to specified phone numbers.
• Storing transaction details in a SQLite database.
• Retrieving and summarizing transaction history.
• Checking account balance on Africa's Talking.
• Supports African countries where service is available.
• Works with AI clients like Claude Desktop and Goose.

Use cases of Africa's Talking Airtime MCP?

• Check your Africa's Talking account balance.
• Send airtime to a phone number.
• View recent top-up transactions.
• Calculate total amount of recent top-ups.
• Count how many times a specific number was topped up.

FAQ from Africa's Talking Airtime MCP

What are the dependencies to run this server?

Requires Python 3.10 or higher, uv, and an Africa's Talking account with a username and API key.

Where is transaction data stored?

All transaction details are stored in a local SQLite database file (airtime_transactions.db) created in the project directory.

What countries are supported?

The server