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

2. Connect to Claude

Claude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "africa-api": {
      "command": "npx",
      "args": ["-y", "africa-api-mcp"],
      "env": {
        "AFRICA_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code — add to ~/.claude/settings.json:

{
  "mcpServers": {
    "africa-api": {
      "command": "npx",
      "args": ["-y", "africa-api-mcp"],
      "env": {
        "AFRICA_API_KEY": "your-api-key-here"
      }
    }
  }
}

Restart Claude and you're ready to go. No install step needed — npx handles it automatically.

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

40 tools across 9 domains:

Domain	Tools	What It Covers
Countries	4	Country details, profiles, real-time signals for all 54 nations
Indicators & Data	4	127+ indicators (GDP, population, health, education, 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	7	Stock exchanges, listed securities, price history, FX rates
Trade	4	Bilateral trade flows, top partners, product breakdowns
Policies	6	Laws, regulations, policy timelines, lifecycle events
Sources	2	Data provenance — World Bank, UN, central banks, etc.
Geographies	1	Continent / region / subregion hierarchy

All tools are read-only with proper MCP safety annotations.

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

africa-api-mcp

Quick Install