Country Explorer Athena Agent

An Athena-compatible MCP agent and interactive dashboard for exploring country data. The server exposes a get_country_info tool, serves an embeddable country dashboard widget, and includes HTTP endpoints that make the same data available in a browser.

What it does

Looks up countries by common name, official name, ISO code, alternate spellings, translations, and native names.
Returns structured demographic, geographic, currency, language, flag, border, map, and Gini-index data.
Serves a glassmorphism-style country dashboard at / and /country-explorer.html.
Supports both MCP transports:
- Streamable HTTP at /mcp
- SSE at /sse with messages posted to /messages
Provides a simple health check at /health.
Uses local datasets (world-countries plus populations.json) for fast country lookup without relying on client-side CORS.

Tech stack

Node.js + Express
Model Context Protocol SDK
world-countries for country metadata
Static population enrichment from populations.json
Plain HTML/CSS/JavaScript dashboard in public/country-explorer.html

Quick start

npm install
npm start

The server defaults to port 8080:

http://localhost:8080

You can override the port with an environment variable:

PORT=3000 npm start

API endpoints

Browser dashboard

GET /
GET /country-explorer.html

Country lookup JSON

GET /api/country?name=Canada

Example:

curl "http://localhost:8080/api/country?name=Canada"

Health check

GET /health

Returns:

{
  "status": "ok",
  "activeSessions": 0
}

MCP tool

The agent exposes one MCP tool:

`get_country_info`

Fetches country details and returns both text output and structured content for the dashboard widget.

Input schema:

{
  "country": "Canada"
}

The structured response includes fields such as:

name
officialName
capital
population
populationRaw
region
subregion
area
flagEmoji
flagUrl
currencies
languages
gini
borders
landlocked
latlng
mapLink

MCP connection

Streamable HTTP

Use /mcp for stateless MCP clients that support streamable HTTP.

http://localhost:8080/mcp

SSE

Use /sse for SSE clients. Client messages are posted to /messages with the session ID provided by the SSE transport.

http://localhost:8080/sse

Deployment

The project includes vercel.json for Vercel deployment with index.js as the serverless entry point.

vercel deploy

Project structure

.
├── index.js                         # Express server and MCP agent
├── package.json                     # Node scripts and dependencies
├── package-lock.json                # Locked dependency versions
├── populations.json                 # Static population lookup by ISO-2 code
├── public/
│   └── country-explorer.html        # Interactive dashboard widget
└── vercel.json                      # Vercel routing/build config

Notes

The dashboard can run inside an Athena/MCP app bridge through window.openai.callTool.
When no bridge is present, the page injects a mock window.openai interface that calls the local /api/country endpoint, so it also works directly in a browser.
Some Gini data is manually enriched for common countries in index.js; countries without a local Gini entry return N/A.

License

MIT