Skip to main content
Glama
Satyampatel779

country-analytics-mcp

by Satyampatel779
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MCP_TRANSPORTNoTransport to use. Set to 'http' to run the server in HTTP mode at http://127.0.0.1:8000/mcp. Defaults to stdio if not set.stdio

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_continentsA

List the seven continent codes (AF AN AS EU NA OC SA) with names and how many countries the country-list source has for each. Start here to find a continent code.

list_countriesA

List every country the source lists for a continent (e.g. 'EU'), with ISO codes, both sources' names, currencies, and whether each could be matched in the World Bank. Answers "how many countries are in ?" via countries_listed_by_source.

get_country_metricA

One country's gdp, population, or gdp_per_capita for a year.

  • country: ISO2/ISO3 code or a name from either source ("France", "FR", "FRA", "Czechia").

  • metric: gdp | population | gdp_per_capita (GDP divided by population, same year).

  • year: a year like "2022", or "latest" (walks back past null years and reports year_used).

  • currency: any Frankfurter-supported currency (GDP is natively current US$).

  • fx_date: "YYYY-MM-DD" or "latest". Default: year-end of a pinned year (falls back to the last trading day, e.g. 2022 -> 2022-12-30), or the latest rate when year='latest'. The response includes the exact year used, FX rate and date, flags, and sources.

region_totalA

Regional total for a continent: sum of GDP, sum of population, or population-weighted GDP per capita (sum GDP / sum population). All judgment calls are parameters:

  • scope: 'continent' = the geographic continent per the country-list source (default); 'wb_region' = the World Bank region(s) overlapping it — a DIFFERENT country set (e.g. Europe & Central Asia adds Central Asia and the Caucasus).

  • year: "2022" or "latest" (latest walks back per country and may mix years — flagged).

  • missing_policy (pinned years): 'exclude' = countries without that year's value are excluded and listed (default); 'walk_back' = use their most recent earlier value.

  • currency / fx_date: as in get_country_metric. The response lists every included country with its value and year, every exclusion with its reason, the FX rate used, and the assumptions applied.

rank_countriesA

Top-N (or bottom-N with order='asc') countries of a continent by gdp, population, or gdp_per_capita. Same scope/year/currency/fx_date semantics as region_total. Countries without data for the requested year are excluded and listed with reasons.

convert_currencyA

Convert an amount between two Frankfurter-supported currencies at the latest rate or a pinned historical date ("YYYY-MM-DD"; non-trading days fall back to the prior trading day and the response says so). Unsupported currencies are refused with the supported list.

list_reconciliation_issuesA

Every disagreement found while reconciling the three sources for a continent: countries missing from the World Bank, name mismatches (joined on ISO2 instead), excluded aggregate rows, currencies the FX source doesn't cover, and how the World Bank region differs from the geographic continent. Use this to explain any number's coverage.

describe_methodologyA

How every number is produced: sources, join key, scope/year/FX/missing-value defaults, and which parameters change them. Use this to answer "how did you get that?".

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4/5.0

Scored across 8 tools

Disambiguation4/5

Tools are mostly distinct: list_continents, list_countries, and get_country_metric target different granularities, while region_total and rank_countries differ by aggregation vs ranking. However, both region_total and rank_countries share identical scope/year/currency semantics and could be confused for aggregate queries, and get_country_metric is buried despite its importance.

Naming Consistency5/5

All tool names follow a clear verb_noun pattern (list_continents, get_country_metric, region_total, convert_currency, describe_methodology). The only slight deviation is region_total and rank_countries which omit an explicit verb, but they remain readable and consistent within the set.

Tool Count5/5

Eight tools is well-scoped for a country analytics server: listing entities, fetching metrics, aggregating, ranking, converting currency, and explaining reconciliation/methodology. Each tool earns its place without redundancy.

Completeness5/5

The surface covers the full lifecycle: discovery (continents, countries), retrieval (get_country_metric), aggregation (region_total), ranking (rank_countries), currency conversion, and transparency tools (list_reconciliation_issues, describe_methodology). No obvious gaps for the stated domain.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources