English Français العربية

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

السجل الرسمي الذكاء الاصطناعي والوكلاء

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

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع 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?"

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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 (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>"
            }
        }
    }
}

متغيرات البيئة

  • AFRICA_API_KEY إلزامي سري Your Africa API bearer token from africa-api.com

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو io.github.africa-api/africa-api-mcp؟

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

كيف أثبّت io.github.africa-api/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 من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.africa-api/africa-api-mcp إلى مفتاح API؟

نعم. يتطلب AFRICA_API_KEY، وتضبطها في إعداداته.

هل io.github.africa-api/africa-api-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.africa-api/africa-api-mcp؟

ينشره africa-api. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.