ESCAP Data Explorer MCP Server

An MCP (Model Context Protocol) server that provides official statistical data for development indicators in Asia-Pacific. It wraps the ESCAP Data Explorer API, letting any MCP-compatible host query SDG and thematic data through natural language.

Live endpoint: https://dataexplorer.unescap.org/mcp/message

What is this?

The ESCAP Data Explorer is the official statistical platform of the United Nations Economic and Social Commission for Asia and the Pacific (ESCAP). It publishes hundreds of SDG and thematic indicators covering poverty, gender, environment, health, trade, and more — across 58 Asia-Pacific countries and territories.

This MCP server wraps the ESCAP Data Explorer's SDMX v2.1 REST API and exposes it as five structured tools that an AI agent can call in sequence to discover, validate, and retrieve statistical data — all through natural language.

Related MCP server: unicefstats-mcp

Example use cases

• "What is the poverty headcount ratio in Thailand between 2010 and 2022?"

• "Show me SDG 5 gender equality indicators available for South Asia."

• "Compare CO₂ emissions per capita across ASEAN countries from 2000 to 2020."

• "Which Asia-Pacific countries have data on maternal mortality after 2015?"

• "Summarize progress on SDG 1 (No Poverty) for least developed countries."

Tools

The server exposes five tools that follow a guided workflow:

Quickstart — use the public endpoint

The server is already deployed and publicly accessible. No installation needed.

Claude Desktop

Install mcp-remote if you haven't already:

npm install -g mcp-remote

Add to your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "escap-data-explorer": {
      "command": "mcp-remote",
      "args": ["https://dataexplorer.unescap.org/mcp/message"]
    }
  }
}

Restart Claude Desktop. The five ESCAP tools will appear automatically.

Other MCP clients (native Streamable HTTP)

{
  "mcpServers": {
    "escap-data-explorer": {
      "url": "https://dataexplorer.unescap.org/mcp/message"
    }
  }
}

Self-hosting

Requirements

• Node.js 18 or later

• npm 8 or later

• Docker + Docker Compose (for server deployment)

1. Clone the repository

git clone https://github.com/your-org/escap-mcp.git
cd escap-mcp

2. Install and build

npm install
npm run build

3. Run locally (stdio mode — for development)

node dist/index.js

Test with Claude Desktop by pointing to the local binary:

{
  "mcpServers": {
    "escap-data-explorer": {
      "command": "node",
      "args": ["/absolute/path/to/escap-mcp/dist/index.js"]
    }
  }
}

4. Deploy with Docker

Build the image:

docker build -t escap-mcp:latest .
docker compose up -d

Verify the server is running:

curl http://localhost:9000/health
# {"status":"ok","transport":"streamable-http","messagePath":"/message"}

Configuration

All configuration is via environment variables:

Reverse proxy (Apache)

If deploying behind Apache, replace your /mcp/ location block with the following. The key directive is flushpackets=on, which prevents Apache from buffering the streaming HTTP response:

<Location /mcp/>
    ProxyPass http://localhost:9000/ flushpackets=on flushwait=1
    ProxyPassReverse http://localhost:9000/

    ProxyPreserveHost On
    RequestHeader set X-Forwarded-Proto "https"

    SetEnv no-gzip 1
    SetEnv dont-vary 1
</Location>

Required modules: mod_proxy, mod_proxy_http, mod_headers.

sudo a2enmod proxy proxy_http headers
sudo systemctl reload httpd

API reference

This server connects to the ESCAP Data Explorer SDMX v2.1 REST API. The underlying endpoints used are:

Dataset types are either SDG (Sustainable Development Goals) or Theme (thematic indicators).

Transport

The server implements the Streamable HTTP MCP transport (the current standard as of MCP SDK 1.x). Legacy SSE transport is not supported.

• Endpoint: POST /message — all client-to-server communication

• Session management: via Mcp-Session-Id request/response header

• Server push: GET /message with Mcp-Session-Id header

Project structure

escap-mcp/
├── src/
│   └── index.ts          # All server logic (single file)
├── dist/                 # Compiled output (after npm run build)
├── Dockerfile            # Two-stage Alpine build
├── docker-compose.yml    # Production deployment
├── apache-mcp.conf       # Apache reverse proxy config snippet
├── tsconfig.json
└── package.json

GitHub topic tags

Add these topics to your GitHub repository (Settings → Topics):

mcp mcp-server model-context-protocol asia-pacific statistics open-data sdmx unescap sustainable-development-goals sdg

Contributing

Contributions are welcome. Please open an issue first to discuss what you'd like to change.

License

MIT — see LICENSE for details.

About ESCAP

The United Nations Economic and Social Commission for Asia and the Pacific (ESCAP) is the regional development arm of the United Nations for the Asia-Pacific region. The ESCAP Data Explorer provides free, open access to official statistics from member states across economic, social, and environmental dimensions.