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 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