# World Bank Intelligence MCP — 17K Development Indicators (`andrew_avina/worldbank-intelligence-mcp`) Actor Access the World Bank Open Data API through a fully MCP-compatible server. Query GDP, inflation, unemployment, poverty, education, and 25+ curated development indicators for 217 countries. Works directly with Claude Desktop, Cursor, GPT-4 plugins, and any MCP client. No API ke... - **URL**: https://apify.com/andrew\_avina/worldbank-intelligence-mcp.md - **Developed by:** [Andrew Avina](https://apify.com/andrew_avina) (community) - **Categories:** MCP servers, Business - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $3.00 / 1,000 result item returneds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## World Bank Intelligence MCP — 17,000+ Development Indicators, 217 Countries Access the **World Bank Open Data** API through a fully MCP-compatible server. Query GDP, inflation, unemployment, poverty, education, and 25+ curated development indicators for 217 countries. Works directly with Claude Desktop, Cursor, GPT-4 plugins, and any MCP client. No API key required. --- ### What This Actor Does The World Bank Open Data platform hosts over 17,000 development indicators spanning 217 countries from 1960 to the present. This Apify actor wraps the public World Bank API in a production-grade MCP server, making it trivially easy for AI assistants to access macroeconomic intelligence. **In batch mode**, you specify an indicator, a list of countries, and a year range. The actor fetches the data, normalises it into clean records, and pushes results to the Apify dataset. **In MCP server mode**, the actor starts a lightweight HTTP server on port 4321. Your AI assistant can call any of the 5 MCP tools in real time. The server runs until you stop the actor (up to 24 hours per run). --- ### Curated Indicator Library (27 Indicators) Rather than memorising obscure World Bank indicator IDs, use the human-readable keys below. The actor also accepts raw WB indicator IDs directly (e.g. `NY.GDP.MKTP.CD`). #### Economic Indicators | Key | World Bank ID | Description | |-----|--------------|-------------| | `gdp` | NY.GDP.MKTP.CD | GDP (current US$) | | `gdp_growth` | NY.GDP.MKTP.KD.ZG | GDP growth rate (% annual) | | `gdp_per_capita` | NY.GDP.PCAP.CD | GDP per capita (current US$) | | `inflation` | FP.CPI.TOTL.ZG | Inflation, CPI (% annual) | | `unemployment` | SL.UEM.TOTL.ZS | Unemployment rate (% of labor force) | | `fdi` | BX.KLT.DINV.CD.WD | Foreign direct investment, net inflows | | `exports` | NE.EXP.GNFS.CD | Exports of goods and services (current US$) | | `imports` | NE.IMP.GNFS.CD | Imports of goods and services (current US$) | | `trade_percent_gdp` | NE.TRD.GNFS.ZS | Trade as % of GDP | | `current_account` | BN.CAB.XOKA.CD | Current account balance (BoP, current US$) | | `debt_gdp` | GC.DOD.TOTL.GD.ZS | Central government debt (% of GDP) | | `reserves` | FI.RES.TOTL.CD | Total reserves including gold (current US$) | #### Social Indicators | Key | World Bank ID | Description | |-----|--------------|-------------| | `population` | SP.POP.TOTL | Total population | | `pop_growth` | SP.POP.GROW | Population growth rate (% annual) | | `life_expectancy` | SP.DYN.LE00.IN | Life expectancy at birth (years) | | `infant_mortality` | SP.DYN.IMRT.IN | Infant mortality rate (per 1,000 live births) | | `literacy_rate` | SE.ADT.LITR.ZS | Adult literacy rate (% ages 15+) | | `school_enrollment` | SE.PRM.ENRR | Primary school enrollment, gross (%) | | `poverty_rate` | SI.POV.NAHC | Poverty headcount at national poverty lines (%) | | `gini` | SI.POV.GINI | Gini index (income inequality) | | `internet_users` | IT.NET.USER.ZS | Internet users (% of population) | | `mobile_subscriptions` | IT.CEL.SETS.P2 | Mobile cellular subscriptions (per 100 people) | #### Environmental Indicators | Key | World Bank ID | Description | |-----|--------------|-------------| | `co2_emissions` | EN.ATM.CO2E.KT | CO2 emissions (kilotonnes) | | `renewable_energy` | EG.FEC.RNEW.ZS | Renewable energy consumption (% of total) | | `electricity_access` | EG.ELC.ACCS.ZS | Access to electricity (% of population) | | `forest_area` | AG.LND.FRST.ZS | Forest area (% of land area) | | `agri_land` | AG.LND.AGRI.ZS | Agricultural land (% of land area) | --- ### MCP Tools #### `get_indicator` Get time-series data for a specific indicator across one or more countries. ```json { "name": "get_indicator", "arguments": { "indicator": "gdp_growth", "countries": ["US", "CN", "IN", "BR"], "years": 10 } } ```` Returns an array of records with fields: `country`, `country_code`, `indicator`, `indicator_id`, `year`, `value`, `unit`, `source`. #### `compare_countries` Side-by-side comparison of multiple countries on a single indicator. ```json { "name": "compare_countries", "arguments": { "countries": ["US", "DE", "JP", "KR"], "indicator": "debt_gdp", "years": 5 } } ``` #### `search_indicators` Discover World Bank indicators by keyword. Returns indicator ID, name, topics, and whether it has a curated key. ```json { "name": "search_indicators", "arguments": { "query": "renewable energy", "limit": 15 } } ``` #### `get_country_profile` Snapshot of key stats for a country — GDP, per capita income, inflation, unemployment, population, life expectancy, poverty, internet access, and CO2 emissions (most recent year). ```json { "name": "get_country_profile", "arguments": { "country_code": "IN", "indicators": ["gdp", "gdp_per_capita", "inflation", "population", "life_expectancy"] } } ``` #### `list_indicators` List all 27 curated indicators with keys, World Bank IDs, names, and categories. ```json { "name": "list_indicators", "arguments": {} } ``` *** ### Input Parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `indicator` | string | `gdp` | Curated key or raw WB indicator ID | | `countries` | array | `["US","CN","DE"]` | ISO-2 country codes | | `years` | integer | `10` | Most-recent years to retrieve (max 60) | | `serveMcp` | boolean | `false` | Start MCP server on port 4321 | *** ### Output Record Schema ```json { "country": "United States", "country_code": "USA", "indicator": "GDP growth (%)", "indicator_id": "NY.GDP.MKTP.KD.ZG", "year": "2023", "value": 2.5, "unit": "", "source": "worldbank.org" } ``` *** ### Example Use Cases **Q: How fast is India's economy growing compared to China?** ``` Tool: get_indicator indicator: gdp_growth, countries: [IN, CN], years: 10 ``` **Q: Which G20 country has the highest debt-to-GDP ratio?** ``` Tool: compare_countries indicator: debt_gdp, countries: [US, JP, DE, FR, IT, GB, CN, IN, BR, CA], years: 1 ``` **Q: What is Kenya's current economic and social profile?** ``` Tool: get_country_profile country_code: KE ``` **Q: Find indicators related to climate change.** ``` Tool: search_indicators query: climate change ``` *** ### Country Code Reference Use ISO 3166-1 alpha-2 codes. Common examples: | Code | Country | Code | Country | |------|---------|------|---------| | US | United States | CN | China | | DE | Germany | IN | India | | GB | United Kingdom | BR | Brazil | | JP | Japan | ZA | South Africa | | FR | France | MX | Mexico | | AU | Australia | KR | South Korea | | CA | Canada | SG | Singapore | | NG | Nigeria | EG | Egypt | | ID | Indonesia | PK | Pakistan | | TR | Turkey | SA | Saudi Arabia | Use `"all"` to retrieve data for all 217 countries. Note that results may contain many records and take longer to process. *** ### API Details - **Data source:** World Bank Open Data — `https://api.worldbank.org/v2/` - **Auth:** None required - **Rate limits:** None officially documented; actor respects the API with per-request async calls - **Coverage:** 217 countries, 17,000+ indicators, annual data back to 1960 in many series - **Update frequency:** Monthly by World Bank *** ### MCP Server Mode Set `serveMcp: true` to start the MCP server. Configure your MCP client: ```json { "mcpServers": { "worldbank": { "url": "http://:4321" } } } ``` The server stays alive for up to 24 hours per run. Use the Apify API to start/stop on demand. **Endpoints:** - `GET /mcp/tools` — returns all 5 tool schemas - `POST /mcp/call` — invoke a tool with `{"name": "...", "arguments": {...}}` - `GET /health` — liveness check *** ### Error Handling All tool functions catch exceptions and return a structured error record rather than crashing: ```json [{"_meta": {"error": "...", "fallback_tried": true}}] ``` Invalid country codes return empty data (World Bank returns no records for unknown codes). Invalid indicator keys that are not in the curated library are passed through to the WB API as raw IDs. *** ### License World Bank data is available under the Creative Commons Attribution 4.0 International license (CC BY 4.0). Actor code is MIT-licensed. # Actor input Schema ## `indicator` (type: `string`): Curated indicator key or raw World Bank indicator ID. Curated keys: gdp, gdp\_growth, gdp\_per\_capita, inflation, unemployment, fdi, exports, imports, trade\_percent\_gdp, current\_account, debt\_gdp, reserves, population, pop\_growth, life\_expectancy, infant\_mortality, literacy\_rate, school\_enrollment, poverty\_rate, gini, internet\_users, mobile\_subscriptions, co2\_emissions, renewable\_energy, electricity\_access, forest\_area, agri\_land. Raw ID example: NY.GDP.MKTP.CD. ## `countries` (type: `array`): List of ISO 3166-1 alpha-2 country codes (e.g. US, CN, DE, IN, BR, GB, JP, FR). Use 'all' to retrieve data for all 217 countries (results may be large). Defaults to US, CN, DE. ## `years` (type: `integer`): How many most-recent years of data to retrieve per country (default 10, max 60). ## `serveMcp` (type: `boolean`): When enabled, starts an MCP-compatible HTTP server on port 4321 instead of running a batch query. Use this mode to connect Claude Desktop, Cursor, or any MCP client to live World Bank data. The actor will run continuously until stopped. Exposes 5 tools: get\_indicator, compare\_countries, search\_indicators, get\_country\_profile, list\_indicators. ## Actor input object example ```json { "indicator": "gdp", "countries": [ "US", "CN", "DE" ], "years": 10, "serveMcp": false } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("andrew_avina/worldbank-intelligence-mcp").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("andrew_avina/worldbank-intelligence-mcp").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call andrew_avina/worldbank-intelligence-mcp --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=andrew_avina/worldbank-intelligence-mcp", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "World Bank Intelligence MCP — 17K Development Indicators", "description": "Access the World Bank Open Data API through a fully MCP-compatible server. Query GDP, inflation, unemployment, poverty, education, and 25+ curated development indicators for 217 countries. Works directly with Claude Desktop, Cursor, GPT-4 plugins, and any MCP client. No API ke...", "version": "0.1", "x-build-id": "W5LEhBWHP4i7NArtY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/andrew_avina~worldbank-intelligence-mcp/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-andrew_avina-worldbank-intelligence-mcp", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/andrew_avina~worldbank-intelligence-mcp/runs": { "post": { "operationId": "runs-sync-andrew_avina-worldbank-intelligence-mcp", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/andrew_avina~worldbank-intelligence-mcp/run-sync": { "post": { "operationId": "run-sync-andrew_avina-worldbank-intelligence-mcp", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "indicator": { "title": "Development Indicator", "type": "string", "description": "Curated indicator key or raw World Bank indicator ID. Curated keys: gdp, gdp_growth, gdp_per_capita, inflation, unemployment, fdi, exports, imports, trade_percent_gdp, current_account, debt_gdp, reserves, population, pop_growth, life_expectancy, infant_mortality, literacy_rate, school_enrollment, poverty_rate, gini, internet_users, mobile_subscriptions, co2_emissions, renewable_energy, electricity_access, forest_area, agri_land. Raw ID example: NY.GDP.MKTP.CD.", "default": "gdp" }, "countries": { "title": "Country Codes", "type": "array", "description": "List of ISO 3166-1 alpha-2 country codes (e.g. US, CN, DE, IN, BR, GB, JP, FR). Use 'all' to retrieve data for all 217 countries (results may be large). Defaults to US, CN, DE.", "default": [ "US", "CN", "DE" ] }, "years": { "title": "Number of Years", "minimum": 1, "maximum": 60, "type": "integer", "description": "How many most-recent years of data to retrieve per country (default 10, max 60).", "default": 10 }, "serveMcp": { "title": "MCP Server Mode", "type": "boolean", "description": "When enabled, starts an MCP-compatible HTTP server on port 4321 instead of running a batch query. Use this mode to connect Claude Desktop, Cursor, or any MCP client to live World Bank data. The actor will run continuously until stopped. Exposes 5 tools: get_indicator, compare_countries, search_indicators, get_country_profile, list_indicators.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```