afrotools/afrotools

AI-ready registry of structured API specs for African providers. Powers the Afro.tools MCP server and Claude Code plugin. # Afro.tools — AI-ready infrastructure for African APIs > Integrate Wave, Paycard, and any African API in a single prompt. African APIs are production-grade. What's been missing is a standard, machine-readable format that AI agents can consume directly — without parsing documentation pages or guessing at request shapes. Afro.tools fills that gap: a static, open-source registry of structured specs for African APIs. Each spec is verified against the live API and exposes exactly what an AI agent needs to generate correct integration code on the first try. --- ## How it works ```mermaid graph LR A["specs/ — open source"] -->|GitHub raw URLs| B["MCP server\nmcp.afro.tools"] B -->|MCP protocol| C["AI agent\nClaude · Cursor · Copilot · ..."] C -->|generates| D["Integration code\nin your app"] A -->|plugin| C ``` --- ## What is a spec? A spec lives at `specs/{category}/{provider}/{capability}/` and contains exactly two files: - **`schema.json`** — ATSS-compliant description of the API capability (endpoint, auth, input/output schemas, gotchas) - **`canonical_example.ts`** — TypeScript implementation using native fetch, compiles with `tsc --noEmit` Each provider also has a **`provider.json`** at the root of its folder: ``` specs/payment/paycard/ ├── provider.json ← metadata + description + example_prompt ├── create_payment/ │ ├── schema.json │ └── canonical_example.ts ├── verify_payment/ └── webhook_payment_completed/ ``` See ATSS.md for the full specification. --- ## Providers | Provider | Category | Country | Capabilities | Status | |----------|----------|---------|--------------|--------| | Paycard | payment | 🇬🇳 | 3 | ✅ AI Ready | | Djomy | payment | 🇬🇳 | 7 | 4 verified · 3 ready | | LengoPay | payment | 🇬🇳 | 8 | 2 verified · 6 ready | | Africa's Talking | sms | 🇧🇫 🇧🇯 🇨🇮 +17 | 2 | 📋 Ready | | Bictorys | payment | 🇸🇳 🇨🇮 🇬🇳 +7 | 4 | 📋 Ready | | Flutterwave | payment | 🇳🇬 🇬🇭 🇰🇪 +10 | 57 | 📋 Ready | | KadevPay | payment | 🇨🇮 | 3 | 📋 Rea …