Tool Reference
SMS Tools (SendAfrica)
send_sms
Send a single SMS to a recipient via SendAfrica.
| Name | Type | Required | Description |
|---|---|---|---|
to | string | Yes | Recipient phone number |
message | string | Yes | SMS message text |
sender_id | string | No | Custom sender ID |
{
"to": "+255712345678",
"message": "Your verification code is 4921.",
"sender_id": "SendAfrika"
}Billing: 1 credit per 160 standard characters (1 SMS part).
send_bulk_sms
Send an SMS message to 2 or more recipient phone numbers.
| Name | Type | Required | Description |
|---|---|---|---|
recipients | string[] | Yes | List of recipient phone numbers |
message | string | Yes | SMS message text |
sender_id | string | No | Custom sender ID |
confirmed | boolean | No | Must be true if sending to >10 recipients |
Guardrail: Sending to more than 10 recipients requires explicit user confirmation.
get_delivery_status
Check delivery status of sent SMS messages.
| Name | Type | Required | Description |
|---|---|---|---|
message_id | string | No | Message ID to query |
list_contacts
List or search contacts within the account phonebook.
| Name | Type | Required | Description |
|---|---|---|---|
list_id | string | No | Contact list ID (default: "1") |
query | string | No | Search term for contact name or phone |
create_campaign
Create and schedule a bulk SMS campaign.
| Name | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Campaign name |
message | string | Yes | Campaign message text |
contact_group_id | string | Yes | Target contact list ID |
scheduled_at | string | No | UTC timestamp for scheduled delivery |
Guardrail: Always requires explicit user confirmation before execution.
get_account_balance
Check current SMS credit and wallet balance. Parameters: None
get_usage_summary
Summarize SMS sent, delivered, and failed for a given time period.
| Name | Type | Required | Description |
|---|---|---|---|
period | string | No | today, this_week, or this_month |
Email Tools (MailAfrica)
send_email
Send a transactional email through MailAfrica.
| Name | Type | Required | Description |
|---|---|---|---|
to | string[] | Yes | List of recipient email addresses |
subject | string | Yes | Email subject line |
body | string | Yes | Email body content |
from_address | string | No | Sender address |
confirmed | boolean | No | Must be true if sending to >5 recipients |
list_inbound_emails
List received inbound emails for a MailAfrica receiving address.
| Name | Type | Required | Description |
|---|---|---|---|
address_id | integer | No | Inbound address ID (default: 1) |
limit | integer | No | Number of emails to retrieve (default: 20) |
get_email_balance
Check MailAfrica email balance and credit ledger. Parameters: None
Documentation Tools
search_documentation
Search REST API docs and SDK code samples.
| Name | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Topic or keyword |
target | string | No | all, docs.sendafrica.online, or sdk.sendafrica.online |
Available Topic IDs:
| ID | Title | Site |
|---|---|---|
auth | API Authentication | docs.sendafrica.online |
sms_send | Send Single SMS | docs.sendafrica.online |
sms_bulk | Send Bulk SMS | docs.sendafrica.online |
webhooks | Inbound SMS Webhooks | docs.sendafrica.online |
python_sdk | Python SDK Guide | sdk.sendafrica.online |
nodejs_sdk | TypeScript/Node.js SDK Guide | sdk.sendafrica.online |
php_sdk | PHP SDK Guide | sdk.sendafrica.online |
pricing_vouchers | Pricing Tiers & Voucher Top-Ups | docs.sendafrica.online |
get_documentation_topic
Fetch full documentation content, endpoints, and code examples for a specific topic.
| Name | Type | Required | Description |
|---|---|---|---|
topic_id | string | Yes | Topic ID from the list above |
Gateway Tools
list_models
List available AI models on the Ngamia gateway. Parameters: None