# Africa's Talking MCP by usefulapi

> Africa's Talking MCP by usefulapi is a freemium MCP server for communication. Check balances, read SMS, and send SMS, airtime and calls via Africa's Talking. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API
- **Website:** https://usefulapi.io/africas-talking/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/africas-talking
- **MCP Registry name:** io.usefulapi/africas-talking
- **Categories:** communication
- **Listing updated:** 2026-11-14

## About

Lets an AI assistant read an Africa's Talking account balance, incoming SMS on a shortcode and transaction status, and send SMS, airtime, mobile data and voice calls.

Send tools spend account credit, so each asks the assistant for your approval first. Airtime and data sends cannot be reversed.

Hosted remote MCP server by usefulapi, an independent service. You sign in with your app username and API key from the Africa's Talking dashboard; the free sandbox app uses the username sandbox.

## Features

- **Balance check:** Read the SMS and airtime wallet and the mobile data wallet balances.
- **Incoming SMS:** Fetch received messages in batches, oldest first.
- **Bulk SMS:** Send one text to up to 100 numbers after approval.
- **Airtime and data:** Send airtime or data bundles to up to 25 numbers after approval.
- **Transaction lookup:** Check an airtime or data transaction by id.
- **Voice calls:** Place outbound calls to up to 10 numbers and read voice queue status.

## Good for

- Check account balance
- Summarize customer SMS replies
- Send an order-ready SMS
- Top up airtime
- Check an airtime transaction

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http africas-talking https://africas-talking.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://africas-talking.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "africas-talking": {
      "url": "https://africas-talking.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "africas-talking": {
      "type": "http",
      "url": "https://africas-talking.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "africas-talking": {
      "serverUrl": "https://africas-talking.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "africas-talking": {
      "type": "http",
      "url": "https://africas-talking.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `africastalking_get_balance`: The Africa's Talking app balance (SMS/airtime wallet), e.g. {"balance": "KES 1250.0000"}. The sandbox app has no balance. GET /version1/user.
- `africastalking_fetch_messages`: Fetch incoming SMS received on your shortcodes/numbers, oldest first, in batches (default 25 per call). Pass last_received_id (0 for the first call, then `next_last_received_id` from the previous reply) to move through them; `has_more` stays true while a call returns messages, so keep calling until `count` is 0. Optional shortcode and keyword filters. GET /version1/messaging.
- `africastalking_send_sms`: WRITE: send one text message to up to 100 phone numbers. Spends account credit and delivers to real phones (the sandbox app only reaches the simulator). Needs confirm=true after the user approved the recipients and text. Returns the vendor's per-recipient status (statusCode 101 = sent), message ids and cost. Never retried. POST /version1/messaging.
- `africastalking_send_airtime`: WRITE: top up mobile airtime for up to 25 phone numbers. Spends account credit immediately and cannot be reversed. Needs confirm=true after the user approved each number and amount. Amounts are in the given ISO currency (e.g. KES, UGX, TZS). Pass an idempotency_key to make a retry safe. Returns per-number status and requestId (use africastalking_find_airtime_transaction to follow up). POST /versio
- `africastalking_find_airtime_transaction`: Look up an airtime transaction by its transaction id (the requestId / ATPid_... from a send reply): status, amount, destination and discount. GET /query/transaction/find.
- `africastalking_send_mobile_data`: WRITE: send mobile data bundles to up to 25 phone numbers from your Africa's Talking data wallet. Spends wallet credit and cannot be reversed. Needs confirm=true after the user approved each number and bundle. product_name is your data product (created in the Africa's Talking dashboard). Pass an idempotency_key to make a retry safe. Returns per-number status and transactionId (see africastalking_f
- `africastalking_find_mobile_data_transaction`: Look up a mobile data transaction by its transactionId (from a send reply): status, product, destination and cost. GET bundles /query/transaction/find.
- `africastalking_get_mobile_data_wallet_balance`: The balance of the mobile data wallet, e.g. {"status": "Success", "balance": "KES 500.0000"}. GET bundles /query/wallet/balance.
- `africastalking_make_voice_call`: WRITE: place an outbound voice call from one of your Africa's Talking numbers to up to 10 phone numbers. The call is billed and rings real phones; what is said is decided by the voice callback URL configured for the number in the dashboard. Needs confirm=true after the user approved the numbers. Live apps only (the sandbox has no voice service). Returns a per-number queue status. POST voice /call.
- `africastalking_get_voice_queue_status`: Number of outbound calls currently queued on each of your voice numbers. Live apps only. POST voice /queueStatus (a read: nothing is changed).

## FAQ

### What do I need to connect Africa's Talking?

The login page asks for app username and API key (Settings, API Key).

### What does the Africa's Talking server cost?

A Free plan gives 50 tool calls per month. Pro is $9/mo ($90/yr) with 10,000 calls per month, and Pro+ is $39/mo ($390/yr) with 100,000 calls per month. Each paid plan covers this server only.

### Is this an official Africa's Talking product?

No. usefulapi is an independent service and is not affiliated with or endorsed by Africa's Talking.

### Which AI clients work with it?

Any client that supports remote MCP servers over Streamable HTTP with OAuth login, including Claude, ChatGPT, Claude Code, Codex, Cursor and VS Code.

### Is Africa's Talking MCP by usefulapi free?

Africa's Talking MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Africa's Talking MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http africas-talking https://africas-talking.usefulapi.io/mcp

### What are the best alternatives to Africa's Talking MCP by usefulapi?

The closest alternatives to Africa's Talking MCP by usefulapi are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

## Alternatives

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/africa-s-talking-mcp-by-usefulapi
