africa-api-mcp 0.3.0 → 0.3.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +22 -24
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -8,25 +8,17 @@ An [MCP](https://modelcontextprotocol.io) server that gives Claude direct access
|
|
|
8
8
|
|
|
9
9
|
Sign up at [africa-api.com](https://africa-api.com) and create an API key from your dashboard.
|
|
10
10
|
|
|
11
|
-
### 2. Connect
|
|
11
|
+
### 2. Connect your client
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
The server runs on demand via `npx` — **nothing to install or host**. Pick your client:
|
|
14
14
|
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
"command": "npx",
|
|
20
|
-
"args": ["-y", "africa-api-mcp"],
|
|
21
|
-
"env": {
|
|
22
|
-
"AFRICA_API_KEY": "your-api-key-here"
|
|
23
|
-
}
|
|
24
|
-
}
|
|
25
|
-
}
|
|
26
|
-
}
|
|
15
|
+
**Claude Code** (one command):
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
claude mcp add africa-api -e AFRICA_API_KEY=your-api-key-here -- npx -y africa-api-mcp
|
|
27
19
|
```
|
|
28
20
|
|
|
29
|
-
**Claude
|
|
21
|
+
**Claude Desktop** — add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows), then restart:
|
|
30
22
|
|
|
31
23
|
```json
|
|
32
24
|
{
|
|
@@ -34,15 +26,21 @@ Sign up at [africa-api.com](https://africa-api.com) and create an API key from y
|
|
|
34
26
|
"africa-api": {
|
|
35
27
|
"command": "npx",
|
|
36
28
|
"args": ["-y", "africa-api-mcp"],
|
|
37
|
-
"env": {
|
|
38
|
-
"AFRICA_API_KEY": "your-api-key-here"
|
|
39
|
-
}
|
|
29
|
+
"env": { "AFRICA_API_KEY": "your-api-key-here" }
|
|
40
30
|
}
|
|
41
31
|
}
|
|
42
32
|
}
|
|
43
33
|
```
|
|
44
34
|
|
|
45
|
-
|
|
35
|
+
**Cursor** — add to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per project) with the same `mcpServers` block as above.
|
|
36
|
+
|
|
37
|
+
**VS Code** (Copilot agent mode) — one command:
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
code --add-mcp '{"name":"africa-api","command":"npx","args":["-y","africa-api-mcp"],"env":{"AFRICA_API_KEY":"your-api-key-here"}}'
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
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](https://registry.modelcontextprotocol.io) as `io.github.africa-api/africa-api-mcp`.
|
|
46
44
|
|
|
47
45
|
## What You Can Ask Claude
|
|
48
46
|
|
|
@@ -60,21 +58,21 @@ Once connected, Claude can answer questions like:
|
|
|
60
58
|
|
|
61
59
|
## Available Tools
|
|
62
60
|
|
|
63
|
-
**
|
|
61
|
+
**41 tools** across 9 domains:
|
|
64
62
|
|
|
65
63
|
| Domain | Tools | What It Covers |
|
|
66
64
|
|--------|-------|----------------|
|
|
67
65
|
| **Countries** | 4 | Country details, profiles, real-time signals for all 54 nations |
|
|
68
|
-
| **Indicators & Data** | 4 |
|
|
66
|
+
| **Indicators & Data** | 4 | 200+ indicators (GDP, population, health, energy, trade, etc.), time-series queries, country rankings |
|
|
69
67
|
| **Government** | 6 | Heads of state, cabinets, leadership terms — current and historical |
|
|
70
68
|
| **Elections** | 5 | Election results, upcoming elections, country overviews |
|
|
71
|
-
| **Markets** |
|
|
69
|
+
| **Markets** | 8 | Stock exchanges, index levels, listed securities, price history, FX rates |
|
|
72
70
|
| **Trade** | 4 | Bilateral trade flows, top partners, product breakdowns |
|
|
73
71
|
| **Policies** | 6 | Laws, regulations, policy timelines, lifecycle events |
|
|
74
|
-
| **Sources** |
|
|
72
|
+
| **Sources & platform** | 3 | Data provenance and platform info — World Bank, IMF, UN, Ember, central banks |
|
|
75
73
|
| **Geographies** | 1 | Continent / region / subregion hierarchy |
|
|
76
74
|
|
|
77
|
-
All tools are **read-only**
|
|
75
|
+
All tools are **read-only** (annotated `readOnly` + `idempotent`) and return both human-readable text and **structured JSON output** for programmatic clients.
|
|
78
76
|
|
|
79
77
|
## Configuration
|
|
80
78
|
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "africa-api-mcp",
|
|
3
3
|
"mcpName": "io.github.africa-api/africa-api-mcp",
|
|
4
|
-
"version": "0.3.
|
|
4
|
+
"version": "0.3.1",
|
|
5
5
|
"description": "MCP server for Africa API — access data on all 54 African countries through Claude",
|
|
6
6
|
"main": "dist/index.js",
|
|
7
7
|
"bin": {
|