English Français العربية

io.github.africa-api/africa-api-mcp

Official registry AI and agents

MCP server for Africa API — access data on all 54 African countries through Claude

Source code Documentation

What can you do with 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?"

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package africa-api-mcp
Claude Code 
claude mcp add africa-api-mcp -e 'AFRICA_API_KEY=<your africa_api_key>' -- npx -y africa-api-mcp@0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "africa-api-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "africa-api-mcp@0.1.1"
            ],
            "env": {
                "AFRICA_API_KEY": "<your africa_api_key>"
            }
        }
    }
}

Environment variables

  • AFRICA_API_KEY required secret Your Africa API bearer token from africa-api.com

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Africa API MCP Server
  2. Quick Start
  3. What You Can Ask Claude
  4. Available Tools
  5. Configuration
  6. Development
  7. License

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:

DomainToolsWhat It Covers
Countries4Country details, profiles, real-time signals for all 54 nations
Indicators & Data4200+ indicators (GDP, population, health, energy, trade, etc.), time-series queries, country rankings
Government6Heads of state, cabinets, leadership terms — current and historical
Elections5Election results, upcoming elections, country overviews
Markets8Stock exchanges, index levels, listed securities, price history, FX rates
Trade4Bilateral trade flows, top partners, product breakdowns
Policies6Laws, regulations, policy timelines, lifecycle events
Sources & platform3Data provenance and platform info — World Bank, IMF, UN, Ember, central banks
Geographies1Continent / 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 VariableRequiredDefaultDescription
AFRICA_API_KEYYes—Your Africa API bearer token
AFRICA_API_BASE_URLNohttps://api.africa-api.comOverride 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

Frequently asked questions

What is io.github.africa-api/africa-api-mcp?

MCP server for Africa API — access data on all 54 African countries through Claude

How do I install io.github.africa-api/africa-api-mcp?

It runs on your machine. In Claude Code: claude mcp add africa-api-mcp -e 'AFRICA_API_KEY=<your africa_api_key>' -- npx -y africa-api-mcp@0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.africa-api/africa-api-mcp need an API key?

Yes. It expects AFRICA_API_KEY, which you set in its configuration.

Is io.github.africa-api/africa-api-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.africa-api/africa-api-mcp?

It is published by africa-api. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.