SendAfrica Agent

An in-app Multi-Channel AI Assistant and FastMCP Server for SendAfrica  (SMS) and MailAfrica  (Transactional Email).

What is SendAfrica Agent?

The SendAfrica Agent is a Python-based service that provides:

• In-App Dashboard Assistant — An intelligent chatbot embedded in the SendAfrica web dashboard that answers questions about pricing, API keys, contacts, and delivery rules.
• FastMCP Tool Server — Exposes 13 tools for AI assistants (Claude, Cursor, Gemini) to interact with SendAfrica SMS and MailAfrica Email APIs.
• Safety Guardrails — Requires explicit user confirmation before executing bulk SMS campaigns or mass email dispatches.
• Multi-Channel Synergy — Manages both SMS (SendAfrica) and Email (MailAfrica) through a unified tool-calling interface.

Quick Links

• Agent Architecture — System design and data flow
• MCP Tools Reference — Complete tool definitions
• API Reference — REST API endpoints and authentication
• SDKs — Python, Node.js, and PHP libraries
• Pricing — Credits, tiers, and mobile money top-ups

Get Started

1. Configure Environment

cp .env.example .env

Set your credentials:

SENDAFRICA_API_BASE=https://api.sendafrica.online/v1
SENDAFRICA_API_KEY=SA-your-key-here
 
MAILAFRICA_API_BASE=https://api.mailafrica.online
MAILAFRICA_API_KEY=MA-your-key-here
 
NGAMIA_BASE_URL=https://api.ngamia.cc/v1
NGAMIA_API_KEY=ngm_your_key_here
NGAMIA_MODEL=openai/gpt-4o-mini

2. Run the Webhook Server

uv run sendafrica-agent serve
# Starts FastAPI server on http://0.0.0.0:8000

3. Run as Stdio MCP Server

uv run sendafrica-agent mcp

Tech Stack