io.github.africa-api/africa-api-mcp
MCP server for Africa API — access data on all 54 African countries through Claude
Que pouvez-vous faire avec io.github.africa-api/africa-api-mcp ?
- "What's the GDP of Nigeria vs South Africa over the last 10 years?"
- "Show me current FX rates for East African currencies"
- "Who is the head of state of Kenya and when did they take office?"
- "What elections are coming up in Africa this year?"
- "What are Nigeria's top 5 export products?"
- "Show me the policy timeline for Rwanda"
- "Rank African countries by life expectancy"
- "What stocks are listed on the Nigerian Exchange?"
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
africa-api-mcpclaude mcp add africa-api-mcp -e 'AFRICA_API_KEY=<your africa_api_key>' -- npx -y africa-api-mcp@0.1.1
{
"mcpServers": {
"africa-api-mcp": {
"command": "npx",
"args": [
"-y",
"africa-api-mcp@0.1.1"
],
"env": {
"AFRICA_API_KEY": "<your africa_api_key>"
}
}
}
}
Variables d'environnement
AFRICA_API_KEYobligatoire secret Your Africa API bearer token from africa-api.com
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
Africa API MCP Server
An MCP server that gives Claude direct access to the Africa API — comprehensive data on all 54 African nations including economic indicators, markets, trade, government, elections, and policies.
Quick Start
1. Get an API key
Sign up at africa-api.com and create an API key from your dashboard.
2. Connect your client
The server runs on demand via npx — nothing to install or host. Pick your client:
Claude Code (one command):
claude mcp add africa-api -e AFRICA_API_KEY=your-api-key-here -- npx -y africa-api-mcp
Claude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart:
{
"mcpServers": {
"africa-api": {
"command": "npx",
"args": ["-y", "africa-api-mcp"],
"env": { "AFRICA_API_KEY": "your-api-key-here" }
}
}
}
Cursor — add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project) with the same mcpServers block as above.
VS Code (Copilot agent mode) — one command:
code --add-mcp '{"name":"africa-api","command":"npx","args":["-y","africa-api-mcp"],"env":{"AFRICA_API_KEY":"your-api-key-here"}}'
Any other MCP client works with the same npx -y africa-api-mcp command plus the AFRICA_API_KEY environment variable. The server is also listed in the MCP Registry as io.github.africa-api/africa-api-mcp.
What You Can Ask Claude
Once connected, Claude can answer questions like:
- "What's the GDP of Nigeria vs South Africa over the last 10 years?"
- "Show me current FX rates for East African currencies"
- "Who is the head of state of Kenya and when did they take office?"
- "What elections are coming up in Africa this year?"
- "What are Nigeria's top 5 export products?"
- "Show me the policy timeline for Rwanda"
- "Rank African countries by life expectancy"
- "What stocks are listed on the Nigerian Exchange?"
- "Compare trade flows between Kenya and Tanzania"
Available Tools
41 tools across 9 domains:
| Domain | Tools | What It Covers |
|---|---|---|
| Countries | 4 | Country details, profiles, real-time signals for all 54 nations |
| Indicators & Data | 4 | 200+ indicators (GDP, population, health, energy, trade, etc.), time-series queries, country rankings |
| Government | 6 | Heads of state, cabinets, leadership terms — current and historical |
| Elections | 5 | Election results, upcoming elections, country overviews |
| Markets | 8 | Stock exchanges, index levels, listed securities, price history, FX rates |
| Trade | 4 | Bilateral trade flows, top partners, product breakdowns |
| Policies | 6 | Laws, regulations, policy timelines, lifecycle events |
| Sources & platform | 3 | Data provenance and platform info — World Bank, IMF, UN, Ember, central banks |
| Geographies | 1 | Continent / region / subregion hierarchy |
All tools are read-only (annotated readOnly + idempotent) and return both human-readable text and structured JSON output for programmatic clients.
Configuration
| Environment Variable | Required | Default | Description |
|---|---|---|---|
AFRICA_API_KEY | Yes | — | Your Africa API bearer token |
AFRICA_API_BASE_URL | No | https://api.africa-api.com | Override for local development |
Development
git clone https://github.com/africa-api/africa-api-mcp.git
cd africa-api-mcp
npm install
npm run build
# Run directly
AFRICA_API_KEY=your-key node dist/index.js
# Test with MCP inspector
AFRICA_API_KEY=your-key npx @modelcontextprotocol/inspector node dist/index.js
License
MIT
Questions fréquentes
Qu'est-ce que io.github.africa-api/africa-api-mcp ?
MCP server for Africa API — access data on all 54 African countries through Claude
Comment installer io.github.africa-api/africa-api-mcp ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add africa-api-mcp -e 'AFRICA_API_KEY=<your africa_api_key>' -- npx -y africa-api-mcp@0.1.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.africa-api/africa-api-mcp ?
Oui. Il attend AFRICA_API_KEY, à renseigner dans sa configuration.
io.github.africa-api/africa-api-mcp est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.africa-api/africa-api-mcp ?
Il est publié par africa-api. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.