Mozart299/agentkit-africa

# AgentKit Africa Agent-first financial infrastructure for East Africa. Built for AI agents — no OAuth flows, no browser redirects, no human in the loop. Covers stablecoin payments (USDC on Stellar), MTN/Airtel Mobile Money, cross-border transfers across East African corridors, and a full MCP server so Claude and other LLM agents can use every primitive as a tool. --- ## What's Inside | Service | Description | |---|---| | **Payments API** | Send/receive USDC on Stellar testnet | | **Mobile Money** | MTN MoMo + Airtel Money disbursements (UG, KE, RW) | | **Cross-Border** | FX-aware transfers across UG→KE→RW corridors | | **KYC** | Programmatic document submission + status polling | | **MCP Server** | All primitives exposed as Claude tools | | **Developer Portal** | Next.js dashboard — balance, transactions, playground, KYC | --- ## Architecture ``` [AI Agent / Claude] │ ├── MCP (stdio) ──► src/mcp/server.ts │ └── REST API ──► Fastify (port 3000) ├── Auth + API keys ├── Payments (Stellar SDK) ├── Mobile Money (MTN + Airtel) ├── FX rates └── Cross-border transfers │ Supabase (Postgres ledger) [Developer Portal] ──► Next.js (port 3001) ``` --- ## Prerequisites - Docker + Docker Compose - A Supabase project (free tier works) - Stellar testnet keypair (generated via Stellar Laboratory or SDK) - MTN MoMo sandbox credentials - Airtel Money sandbox credentials --- ## Setup ### 1. Backend environment Copy and fill in `.env`: ```bash cp .env.example .env ``` Required vars: ```env # Supabase SUPABASE_URL=your-project.supabase.co SUPABASE_SERVICE_KEY=your-service-role-key # Stellar STELLAR_SECRET_KEY=S... # testnet keypair secret STELLAR_NETWORK=testnet # MTN MoMo MTN_BASE_URL=sandbox.momodeveloper.mtn.c… MTN_SUBSCRIPTION_KEY=your-key MTN_API_USER=your-uuid MTN_API_KEY=your-api-key MTN_ENVIRONMENT=sandbox # Airtel Money AIRTEL_CLIENT_ID=your-client-id AIRTEL_CLIENT_SECRET=your-client-secret AIRTEL_ENVIRONMENT=sandbox ``` …