# io.github.africa-api/africa-api-mcp (npm · africa-api-mcp)

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

- Trust score: 65/100 (medium)
- Change this week: +19
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `africa-api-mcp`: 65/100 (this document), [markdown](https://verifymcp.io/servers/africa-api-africa-api-mcp/africa-api-mcp.md), [page](https://verifymcp.io/servers/africa-api-africa-api-mcp/africa-api-mcp)

## Channel facts

- Registry: `npm`
- Package: `africa-api-mcp`
- Version: `0.1.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 86/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 36 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 77/100
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 2684 tokens (~67/item across 40 items; 40 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add africa-api-africa-api-mcp -- npx -y africa-api-mcp
```

### Codex

```bash
codex mcp add africa-api-africa-api-mcp -- npx -y africa-api-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "africa-api-africa-api-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "africa-api-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add africa-api-africa-api-mcp --command npx --arg -y --arg africa-api-mcp
```

### Hermes

```yaml
mcp_servers:
  africa-api-africa-api-mcp:
    command: "npx"
    args: ["-y", "africa-api-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "africa-api-africa-api-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "africa-api-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 65, +44)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional] Licence: MIT

### 2026-08-01 (score 21, −7)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-31 (score 28, −18)

- [security regression] Malware scan: pass → unverified

### 2026-07-27 (score 46)

First indexed and scored.

## MCP tools (40)

### `list_countries` (~81 tokens)

List all 54 African countries with key facts (capital, region, area, currencies, languages)

Input parameters:

- `page` (integer): Page number for pagination
- `per_page` (integer): Items per page
- `region` (string): Filter by region (e.g. "Eastern Africa", "Western Africa")
- `sort` (string): Sort field

### `get_country` (~56 tokens)

Get detailed information about a specific African country including coordinates, borders, currencies, and languages

Input parameters:

- `country_code` (string, required): ISO 3166-1 alpha-2 code (e.g. "NG", "KE", "ZA")

### `get_country_profile` (~51 tokens)

Get a curated profile for a country — key macro, demographic, and economic indicators

Input parameters:

- `country_code` (string, required): ISO alpha-2 code (e.g. "NG", "KE", "ZA")

### `get_country_signals` (~58 tokens)

Get real-time signals for a country — macro snapshot, market data, FX rates, power status, humanitarian alerts

Input parameters:

- `country_code` (string, required): ISO alpha-2 code (e.g. "NG", "KE", "ZA")

### `list_indicators` (~86 tokens)

List all available data indicators (127+) across categories like GDP, population, health, education, agriculture, energy, climate

Input parameters:

- `category` (string): Filter by category (e.g. "economy", "health", "education")
- `has_data` (boolean): If true, only return indicators that have observations
- `source` (string): Filter by data source code

### `get_indicator` (~55 tokens)

Get detailed metadata about a specific indicator including description, unit, source, and available years

Input parameters:

- `metric_key` (string, required): Indicator key (e.g. "gdp_current_usd", "population_total", "life_expectancy")

### `get_indicator_rankings` (~90 tokens)

Rank African countries by a specific indicator for a given year — great for comparisons

Input parameters:

- `limit` (integer): Number of results
- `metric_key` (string, required): Indicator key (e.g. "gdp_current_usd", "population_total")
- `order` (string): Sort order
- `source` (string): Source code filter
- `year` (integer, required): Year to rank by

### `query_data` (~184 tokens)

Query time-series observations for any combination of countries and indicators

Input parameters:

- `category` (string): Filter by indicator category
- `country_code` (string): Single ISO alpha-2 code (e.g. "NG")
- `country_codes` (string): Comma-separated codes (e.g. "NG,KE,ZA")
- `end_year` (integer): End of year range
- `latest` (boolean): Only return most recent observation per country+indicator
- `limit` (integer): Max results
- `metric_key` (string): Single indicator key (e.g. "gdp_current_usd")
- `metric_keys` (string): Comma-separated indicator keys
- `source` (string): Filter by source code
- `start_year` (integer): Start of year range
- `year` (integer): Exact year (cannot combine with start_year/end_year)

### `list_geographies` (~80 tokens)

List geographical entities — continents, regions, subregions, and countries in a hierarchy

Input parameters:

- `country_code` (string): Filter by country code
- `limit` (integer): Max results
- `parent_key` (string): Filter by parent geography key
- `q` (string): Search query
- `type` (string): Filter by geography type

### `get_government_overview` (~54 tokens)

Get a government overview — current head of state, head of government, and cabinet summary

Input parameters:

- `country_code` (string, required): ISO alpha-2 code (e.g. "NG", "KE", "ZA")

### `search_leaders` (~67 tokens)

Search African heads of state and government — current and historical

Input parameters:

- `country_code` (string): Filter by country (ISO alpha-2)
- `current_only` (boolean): Only current leaders
- `limit` (integer): Max results
- `q` (string): Search by name

### `get_leader` (~50 tokens)

Get detailed information about a specific leader including biography, terms, and political party

Input parameters:

- `leader_wikidata_id` (string, required): Wikidata ID of the leader (e.g. "Q7939")

### `list_government_terms` (~111 tokens)

List leadership terms — who governed which country and when

Input parameters:

- `country_code` (string): Filter by country
- `current_only` (boolean): Only current terms
- `end_date_to` (string): Filter terms to date (YYYY-MM-DD)
- `leader_wikidata_id` (string): Filter by leader
- `limit` (integer): Max results
- `role_type` (string): Role type filter
- `start_date_from` (string): Filter terms from date (YYYY-MM-DD)

### `get_cabinet` (~52 tokens)

Get the current cabinet for a country — ministers, deputy ministers, and key officials

Input parameters:

- `country_code` (string, required): ISO alpha-2 code (e.g. "NG", "KE", "ZA")

### `list_cabinet_members` (~70 tokens)

Search cabinet members across African governments

Input parameters:

- `country_code` (string): Filter by country
- `current_only` (boolean): Only current members
- `limit` (integer): Max results
- `q` (string): Search by name
- `role_category` (string): Filter by role

### `list_elections` (~85 tokens)

List elections across Africa — filter by country, scope, status, and year range

Input parameters:

- `country_code` (string): Filter by country
- `election_scope` (string): Election scope
- `end_year` (integer): To year
- `limit` (integer): Max results
- `start_year` (integer): From year
- `status` (string): Election status

### `get_upcoming_elections` (~29 tokens)

Get upcoming elections across Africa sorted by date

Input parameters:

- `limit` (integer): Max results

### `get_country_elections` (~62 tokens)

Get an election overview for a country — recent and upcoming elections with results

Input parameters:

- `country_code` (string, required): ISO alpha-2 code (e.g. "NG", "KE", "ZA")
- `top_limit` (integer): Top results per category

### `get_election` (~34 tokens)

Get detailed information about a specific election

Input parameters:

- `election_wikidata_id` (string, required): Wikidata ID of the election

### `get_election_results` (~51 tokens)

Get results for a specific election — candidates, parties, and vote counts

Input parameters:

- `election_wikidata_id` (string, required): Wikidata ID of the election
- `limit` (integer): Max results

### `list_exchanges` (~47 tokens)

List African stock exchanges — NGX, JSE, BRVM, Casablanca, etc.

Input parameters:

- `country_code` (string): Filter by country
- `limit` (integer): Max results

### `get_exchange` (~41 tokens)

Get details about a specific stock exchange

Input parameters:

- `exchange_code` (string, required): Exchange code (e.g. "NGX", "JSE", "BRVM")

### `list_tickers` (~82 tokens)

Search listed securities (equities) across African exchanges

Input parameters:

- `country_code` (string): Filter by country
- `exchange_code` (string): Filter by exchange (e.g. "NGX")
- `instrument_type` (string): Filter by instrument type
- `limit` (integer): Max results
- `q` (string): Search by name or symbol

### `get_ticker` (~53 tokens)

Get details about a specific listed security

Input parameters:

- `exchange_code` (string, required): Exchange code (e.g. "NGX")
- `symbol` (string, required): Ticker symbol (e.g. "DANGCEM")

### `get_ticker_history` (~82 tokens)

Get price history (OHLC + volume) for a listed security

Input parameters:

- `end_date` (string): End date (YYYY-MM-DD)
- `exchange_code` (string, required): Exchange code
- `limit` (integer): Max data points
- `start_date` (string): Start date (YYYY-MM-DD)
- `symbol` (string, required): Ticker symbol

### `get_fx_rates` (~80 tokens)

Get current FX rates for African currencies against a base currency

Input parameters:

- `base_currency` (string): Base currency (3-letter code)
- `country_code` (string): Filter by country
- `limit` (integer): Max results
- `quote_currencies` (string): Comma-separated quote currencies (e.g. "NGN,KES,ZAR")

### `get_fx_rate_history` (~98 tokens)

Get historical FX rate data for a currency pair

Input parameters:

- `base_currency` (string, required): Base currency (e.g. "USD")
- `end_date` (string): End date (YYYY-MM-DD)
- `limit` (integer): Max data points
- `quote_currency` (string, required): Quote currency (e.g. "NGN", "KES", "ZAR")
- `start_date` (string): Start date (YYYY-MM-DD)

### `get_trade_overview` (~86 tokens)

Get a trade overview — total exports/imports, top partners, top products, and trends

Input parameters:

- `country_code` (string, required): ISO alpha-2 code (e.g. "NG", "KE", "ZA")
- `end_year` (integer): End year
- `start_year` (integer): Start year
- `top_limit` (integer): Top items per category

### `get_trade_flows` (~110 tokens)

Query bilateral trade flows between countries — exports and imports with values

Input parameters:

- `end_year` (integer): End year
- `flow_type` (string): Flow type
- `limit` (integer): Max results
- `partner_country_code` (string): Partner country code
- `product_code` (string): HS product code
- `reporter_country_code` (string): Reporting country (ISO alpha-2)
- `start_year` (integer): Start year
- `year` (integer): Exact year

### `get_trade_partners` (~79 tokens)

Get top trading partners for a country

Input parameters:

- `end_year` (integer): End year
- `flow_type` (string): Flow type
- `limit` (integer): Max results
- `reporter_country_code` (string, required): Reporting country (required)
- `start_year` (integer): Start year
- `year` (integer): Exact year

### `get_trade_products` (~84 tokens)

Get top traded products for a country — what it exports and imports

Input parameters:

- `end_year` (integer): End year
- `flow_type` (string): Flow type
- `limit` (integer): Max results
- `reporter_country_code` (string, required): Reporting country (required)
- `start_year` (integer): Start year
- `year` (integer): Exact year

### `list_policies` (~91 tokens)

Search government policies, laws, and regulations across Africa

Input parameters:

- `country_code` (string): Filter by country
- `document_type` (string): Document type
- `end_year` (integer): To year
- `limit` (integer): Max results
- `q` (string): Search by title or content
- `start_year` (integer): From year
- `status` (string): Policy status

### `get_policy` (~38 tokens)

Get detailed information about a specific policy, law, or regulation

Input parameters:

- `policy_wikidata_id` (string, required): Wikidata ID of the policy

### `get_country_policies` (~63 tokens)

Get a policy overview for a country — recent and notable policies grouped by type

Input parameters:

- `country_code` (string, required): ISO alpha-2 code (e.g. "NG", "KE", "ZA")
- `top_limit` (integer): Top items per category

### `get_country_policy_timeline` (~44 tokens)

Get a chronological policy timeline for a country

Input parameters:

- `country_code` (string, required): ISO alpha-2 code
- `top_limit` (integer): Number of events

### `list_policy_events` (~76 tokens)

List policy lifecycle events — when policies were announced, adopted, amended, repealed

Input parameters:

- `country_code` (string): Filter by country
- `end_year` (integer): To year
- `event_type` (string): Event type
- `limit` (integer): Max results
- `start_year` (integer): From year

### `get_policy_events` (~44 tokens)

Get all lifecycle events for a specific policy

Input parameters:

- `limit` (integer): Max results
- `policy_wikidata_id` (string, required): Wikidata ID of the policy

### `list_sources` (~26 tokens)

List all data sources — World Bank, UN agencies, central banks, exchanges, etc.

### `get_source` (~37 tokens)

Get details about a specific data source — description, URL, coverage, and update frequency

Input parameters:

- `source_code` (string, required): Source code identifier

### `get_platform_info` (~17 tokens)

Get Africa API platform version and status

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/africa-api-africa-api-mcp/africa-api-mcp#diagnostics

## Score history

- 2026-08-03: 65
- 2026-08-02: 65
- 2026-08-01: 21
- 2026-07-31: 28
- 2026-07-29: 46
- 2026-07-28: 46
- 2026-07-27: 46

## Links

- npm package: https://www.npmjs.com/package/africa-api-mcp
- Socket report: https://socket.dev/npm/package/africa-api-mcp
- Repository: https://github.com/africa-api/africa-api-mcp
- Changelog RSS feed: https://verifymcp.io/servers/africa-api-africa-api-mcp/africa-api-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/africa-api-africa-api-mcp/africa-api-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/africa-api-africa-api-mcp/africa-api-mcp