{
  "markdown": "# Africa API MCP Server\n\nAn [MCP](https://modelcontextprotocol.io) server that gives Claude direct access to the [Africa API](https://africa-api.com) — comprehensive data on all 54 African nations including economic indicators, markets, trade, government, elections, and policies.\n\n## Quick Start\n\n### 1. Get an API key\n\nSign up at [africa-api.com](https://africa-api.com) and create an API key from your dashboard.\n\n### 2. Connect your client\n\nThe server runs on demand via `npx` — **nothing to install or host**. Pick your client:\n\n**Claude Code** (one command):\n\n```bash\nclaude mcp add africa-api -e AFRICA_API_KEY=your-api-key-here -- npx -y africa-api-mcp\n```\n\n**Claude Desktop** — add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows), then restart:\n\n```json\n{\n  \"mcpServers\": {\n    \"africa-api\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"africa-api-mcp\"],\n      \"env\": { \"AFRICA_API_KEY\": \"your-api-key-here\" }\n    }\n  }\n}\n```\n\n**Cursor** — add to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per project) with the same `mcpServers` block as above.\n\n**VS Code** (Copilot agent mode) — one command:\n\n```bash\ncode --add-mcp '{\"name\":\"africa-api\",\"command\":\"npx\",\"args\":[\"-y\",\"africa-api-mcp\"],\"env\":{\"AFRICA_API_KEY\":\"your-api-key-here\"}}'\n```\n\nAny 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](https://registry.modelcontextprotocol.io) as `io.github.africa-api/africa-api-mcp`.\n\n## What You Can Ask Claude\n\nOnce connected, Claude can answer questions like:\n\n- \"What's the GDP of Nigeria vs South Africa over the last 10 years?\"\n- \"Show me current FX rates for East African currencies\"\n- \"Who is the head of state of Kenya and when did they take office?\"\n- \"What elections are coming up in Africa this year?\"\n- \"What are Nigeria's top 5 export products?\"\n- \"Show me the policy timeline for Rwanda\"\n- \"Rank African countries by life expectancy\"\n- \"What stocks are listed on the Nigerian Exchange?\"\n- \"Compare trade flows between Kenya and Tanzania\"\n\n## Available Tools\n\n**41 tools** across 9 domains:\n\n| Domain | Tools | What It Covers |\n|--------|-------|----------------|\n| **Countries** | 4 | Country details, profiles, real-time signals for all 54 nations |\n| **Indicators & Data** | 4 | 200+ indicators (GDP, population, health, energy, trade, etc.), time-series queries, country rankings |\n| **Government** | 6 | Heads of state, cabinets, leadership terms — current and historical |\n| **Elections** | 5 | Election results, upcoming elections, country overviews |\n| **Markets** | 8 | Stock exchanges, index levels, listed securities, price history, FX rates |\n| **Trade** | 4 | Bilateral trade flows, top partners, product breakdowns |\n| **Policies** | 6 | Laws, regulations, policy timelines, lifecycle events |\n| **Sources & platform** | 3 | Data provenance and platform info — World Bank, IMF, UN, Ember, central banks |\n| **Geographies** | 1 | Continent / region / subregion hierarchy |\n\nAll tools are **read-only** (annotated `readOnly` + `idempotent`) and return both human-readable text and **structured JSON output** for programmatic clients.\n\n## Configuration\n\n| Environment Variable | Required | Default | Description |\n|---------------------|----------|---------|-------------|\n| `AFRICA_API_KEY` | Yes | — | Your Africa API bearer token |\n| `AFRICA_API_BASE_URL` | No | `https://api.africa-api.com` | Override for local development |\n\n## Development\n\n```bash\ngit clone https://github.com/africa-api/africa-api-mcp.git\ncd africa-api-mcp\nnpm install\nnpm run build\n\n# Run directly\nAFRICA_API_KEY=your-key node dist/index.js\n\n# Test with MCP inspector\nAFRICA_API_KEY=your-key npx @modelcontextprotocol/inspector node dist/index.js\n```\n\n## License\n\nMIT\n",
  "bytes": 3888,
  "sha": "457c046a8d434717f991e7b09fcf78dd2a25f2772d00a68add8f820504a1e37c",
  "repo_slug": "africa-api/africa-api-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_africa_api_africa_api_mcp_88115b14/readme"
}