_ registry / mcp http-sse · checked 3h ago

ilostat-mcp-server

https://ilostat.caseyjhand.com

Registry code: 2448119b9662c02e

api record

ILOSTAT labour statistics are addressed by dataset ID, an indicator code plus a frequency suffix (UNE_DEAP_SEX_AGE_RT_A is the annual unemployment rate; _Q quarterly, _M monthly): find one with ilostat_search_indicators, read its unit and breakdown codes with ilostat_describe_indicator, fetch values with ilostat_query_indicator, and decode any code with ilostat_list_reference. Every value carries a basis (reported, modelled_estimate, or projection): never present a modelled or projected value as reported, and never sum across overlapping classification versions (AGE_YTHADULT_*,…

endpoint
https://ilostat.caseyjhand.com/mcp
protocol
http-sse ·2025-06-18
authentication
none observed
public key
none — nobody has proven they own this listing · is it yours? claim it
karma
0 · newcomer
reachable
live
uptime, 30 days
100%

90 days 100%· all time 100%

latency
314ms

last good check

priced tools
0

of 8 tools

_ answered our checks, 90 days 1 checks · signed record
  • unknown → live
_ used through this hub 30 days

The one measurement on this page that an operator cannot produce by editing a file on its own server: somebody else chose it, and paid to. Read the accounts before the calls — volume from one account is one relationship, and calling yourself is the cheap half. Both are what the ranking is built from, printed so the order can be checked rather than taken on trust.

accounts
0

distinct, expensive to fake

calls served
0

successful, last 30 days

_ what it can do 8 tools
1 open 7 never probed 1 of 8 classified

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

  • ilostat_search_indicators open 3h ago

    Search ILOSTAT's catalog of labour-statistics indicators by plain-language terms and filters. Each hit is one indicator with its datasets — one per available frequency (annual, quarterly, monthly) — plus breakdowns, coverage years, number of reference areas, source database, and last update; pass a dataset ID to ilostat_describe_indicator for its units and breakdown codes, then to ilostat_query_indicator or ilostat_compare_geographies for values. Every search term must match a word or word prefix in the indicator's label, subject, database, breakdown names, code, or definition; British and American spellings (labour/labor) match alike. Facet counts reflect all applied filters.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "Hits per page (1–50)."
    },
    "query": {
      "type": "string",
      "maxLength": 500,
      "description": "Plain-language terms, e.g. \"youth unemployment\" or \"informal employment rate\". Case, accents, and punctuation are ignored, labor matches labour, and a trailing plural s is tolerated. Omit to browse by filters (results then order by indicator code)."
    },
    "cursor": {
      "type": "string",
      "maxLength": 256,
      "description": "Opaque continuation token: the previous page's next_cursor, passed unchanged."
    },
    "subject": {
      "type": "string",
      "maxLength": 32,
      "description": "Subject code, e.g. LUU (unemployment and labour underutilization); case-insensitive. ilostat_list_reference topic subjects lists them."
    },
    "database": {
      "type": "string",
      "maxLength": 32,
      "description": "Source database code, e.g. LFS or ILOEST (the ILO modelled estimates); case-insensitive. ilostat_list_reference topic databases lists them."
    },
    "breakdown": {
      "type": "string",
      "maxLength": 32,
      "description": "Classification type the indicator is broken down by, e.g. AGE, ECO, GEO, SEX; case-insensitive. ilostat_list_reference topic classification_types lists them."
    },
    "frequency": {
      "enum": [
        "A",
        "Q",
        "M"
      ],
      "type": "string",
      "description": "Keep only datasets of this frequency: A annual, Q quarterly, M monthly. Narrows each hit's datasets; an indicator with none left drops out."
    },
    "aggregates_only": {
      "type": "boolean",
      "default": false,
      "description": "Keep only datasets carrying World, regional, or income-group rows, dropping indicators with none."
    }
  },
  "additionalProperties": false
}
    arguments 53 lines
  • ilostat_query_indicator unknown never probed

    Fetch observations for up to 3 ILOSTAT datasets, filtered by reference area or area group, sex, breakdown codes (classif1, classif2), source, and period. Rows keep their source, observation status, decoded notes, and a basis — reported, modelled_estimate, or projection — and the response echoes every filter applied, including the best-source default. Codes are checked against ILOSTAT's dictionaries before the request is sent: ilostat_list_reference lists valid codes and ilostat_describe_indicator lists the codes a dataset actually uses. A result larger than the inline preview is staged in full as a df_<id> dataframe for SQL through ilostat_dataframe_describe and ilostat_dataframe_query when this deployment enables dataframes. A request with no filters at all is refused when the dataset exceeds the row ceiling, and a filtered request that still exceeds it is refused with guidance to narrow it.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_ids"
  ],
  "properties": {
    "sex": {
      "type": "array",
      "items": {
        "enum": [
          "SEX_T",
          "SEX_M",
          "SEX_F",
          "SEX_O"
        ],
        "type": "string"
      },
      "maxItems": 4,
      "description": "Sex codes SEX_T, SEX_M, SEX_F, SEX_O; T/M/F/O and total/both/male/female/other are accepted."
    },
    "time": {
      "type": "string",
      "pattern": "^\\d{4}(Q[1-4]|M(0[1-9]|1[0-2]))?$",
      "description": "One exact period: YYYY (on a quarterly or monthly dataset, every period of that year), YYYYQn, or YYYYMmm; 2024-Q2, 2024 Q2, and 2025-03 are normalized. Not combinable with time_from, time_to, or latest_only."
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 64
      },
      "maxItems": 100,
      "description": "Source codes (e.g. BA:453); ilostat_list_reference topic sources with ref_area lists an area's sources. Without source_selection, setting sources switches it to all, since a secondary source matches nothing under best."
    },
    "time_to": {
      "type": "string",
      "pattern": "^\\d{4}$",
      "description": "Last year (YYYY), not before time_from."
    },
    "classif1": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 64
      },
      "maxItems": 100,
      "description": "Codes of the first breakdown (e.g. AGE_YTHADULT_YGE15); case-insensitive. ilostat_describe_indicator lists the codes a dataset uses."
    },
    "classif2": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 64
      },
      "maxItems": 100,
      "description": "Codes of the second breakdown, for datasets that have one; case-insensitive. ilostat_describe_indicator lists them."
    },
    "ref_areas": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Z0-9]{3}$"
      },
      "maxItems": 300,
      "description": "Reference areas (up to 300): ISO3 country codes (USA) or X-coded aggregates (X01 World); case-insensitive, ILO_GEO_ forms accepted. Aggregates need a dataset with has_aggregates true. Omit for every area."
    },
    "time_from": {
      "type": "string",
      "pattern": "^\\d{4}$",
      "description": "First year (YYYY); upstream filters by year only."
    },
    "area_group": {
      "type": "string",
      "pattern": "^[A-Z0-9]{3}$",
      "description": "X01 for every country, an ILO region or subregion, or a World Bank income group (X06, X56, X02, …); expands to its member countries, unioned with ref_areas. ilostat_list_reference topic area_groups lists the codes."
    },
    "dataset_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Z0-9_]+$",
        "maxLength": 64
      },
      "maxItems": 3,
      "minItems": 1,
      "description": "One to three dataset IDs — an indicator code plus _A, _Q, or _M (UNE_DEAP_SEX_AGE_RT_A), as ilostat_search_indicators returns them. Case-insensitive; a DF_ prefix (the SDMX dataflow form) is stripped, a bare indicator code resolves when it has one frequency, and an element holding + or , joined IDs is split."
    },
    "latest_only": {
      "type": "boolean",
      "default": false,
      "description": "Only the latest period per reference area and dataset (the latest quarter or month on sub-annual datasets); combines with time_from/time_to."
    },
    "source_selection": {
      "enum": [
        "best",
        "all",
        "secondary"
      ],
      "type": "string",
      "description": "best (default): the preferred source per area and period; all: secondary sources too, each row flagged best_source; secondary: secondary sources only. Defaults to all when sources is set."
    }
  },
  "additionalProperties": false
}
    arguments 105 lines
  • ilostat_describe_indicator unknown never probed

    Explain one ILOSTAT dataset before comparing numbers: its definition, unit and multiplier, frequency variants and coverage, the sex and breakdown codes in use across its frequencies (the total code of each breakdown marked), the reference areas it covers, whether it carries World/regional/income-group aggregates, and how its observations are classed as reported, modelled, or projected. Accepts a dataset ID (UNE_DEAP_SEX_AGE_RT_A) or a bare indicator code (UNE_DEAP_SEX_AGE_RT), which describes every frequency. An unknown code returns found: false with guidance.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "dataset_id": {
      "type": "string",
      "pattern": "^[A-Z0-9_]+( *[+,] *[A-Z0-9_]+)*$",
      "maxLength": 200,
      "description": "One dataset ID (indicator code plus _A, _Q, or _M, e.g. UNE_DEAP_SEX_AGE_RT_A) or a bare indicator code (UNE_DEAP_SEX_AGE_RT), as ilostat_search_indicators returns them. Case-insensitive; a DF_ prefix (the SDMX dataflow form) is stripped."
    }
  },
  "additionalProperties": false
}
    arguments 16 lines
  • ilostat_get_country_profile unknown never probed

    Build a headline labour-market profile for one reference area: labour force participation, employment-to-population ratio, unemployment and youth unemployment rates, youth NEET rate, informal employment rate, employment level, labour income share, and working poverty rate. Each indicator shows its latest reported value (from a national or institutional source, with its source and notes) and, separately, its latest ILO modelled estimate that is not a projection, each with its dataset, period, and status — a missing reported value stays missing and is never filled from the model. Accepts a country (ISO3, e.g. KEN) or an X-coded aggregate (X01 World, regions, income groups), for which only modelled values exist.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "ref_area"
  ],
  "properties": {
    "sex": {
      "enum": [
        "SEX_T",
        "SEX_M",
        "SEX_F"
      ],
      "type": "string",
      "default": "SEX_T",
      "description": "SEX_T (default), SEX_M, or SEX_F; T/M/F and total/both/male/female are accepted. Indicators without a sex breakdown (labour income share) are unaffected."
    },
    "ref_area": {
      "type": "string",
      "pattern": "^[A-Z0-9]{3}$",
      "description": "One reference area with annual data: an ISO3 country code (KEN) or an X-coded aggregate (X01 World, X06, X02); ILO_GEO_ forms accepted, case-insensitive. ilostat_list_reference topic ref_areas lists them."
    }
  },
  "additionalProperties": false
}
    arguments 25 lines
  • ilostat_list_reference unknown never probed

    Decode ILOSTAT's code vocabulary: reference areas (ISO3 countries and X-coded aggregates, with World Bank income group and ILO region), the groups that area_group accepts (X01 for every country, ILO regions and subregions, World Bank income groups; exact-code lookups list their member countries), databases, subjects, sex codes, breakdown codes for classif1/classif2 with their classification types, per-country data sources, observation status flags, note codes, and frequencies. Filter by text or look up exact codes; long topics page with a cursor. These are ILOSTAT-wide vocabularies; ilostat_describe_indicator lists the sex and breakdown codes one dataset actually uses.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "topic"
  ],
  "properties": {
    "codes": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 64
      },
      "maxItems": 100,
      "description": "Exact codes to look up (up to 100; case-insensitive, and ILO_GEO_ forms accepted for ref_areas and area_groups). Codes the topic lacks are listed in not_found. With topic area_groups, each group found also lists its member countries."
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 500,
      "minimum": 1,
      "description": "Entries per page (1–500)."
    },
    "topic": {
      "enum": [
        "ref_areas",
        "area_groups",
        "databases",
        "subjects",
        "sexes",
        "classifications",
        "classification_types",
        "sources",
        "obs_status",
        "notes",
        "frequencies"
      ],
      "type": "string",
      "description": "Vocabulary to list: ref_areas, area_groups (the X codes area_group accepts), databases, subjects, sexes, classifications (classif1/classif2 codes), classification_types, sources, obs_status, notes, or frequencies."
    },
    "cursor": {
      "type": "string",
      "maxLength": 256,
      "description": "Opaque continuation token: the previous page's next_cursor, passed unchanged."
    },
    "filter": {
      "type": "string",
      "maxLength": 200,
      "description": "Text filter: every word must match a word or word prefix of the code or label (case, accents, and punctuation ignored; labor matches labour). Omit to list the whole topic."
    },
    "ref_area": {
      "type": "string",
      "pattern": "^[A-Z0-9]{3}$",
      "description": "Topic sources only: list the sources of this reference area (ISO3 or X code; case-insensitive, ILO_GEO_ forms accepted)."
    },
    "classification_type": {
      "type": "string",
      "maxLength": 32,
      "description": "Topic classifications only: keep codes of this classification type, the code prefix (AGE, ECO, EDU, …)."
    }
  },
  "additionalProperties": false
}
    arguments 63 lines
  • ilostat_dataframe_query unknown never probed

    Run a single-statement SELECT against the df_<id> dataframes staged by ilostat_query_indicator and ilostat_compare_geographies or stored by an earlier register_as. Inspect a dataframe with ilostat_dataframe_describe first; its column schema is what the SQL has to match. Read-only: writes, DDL, DROP, COPY, PRAGMA, ATTACH, and file-reading table functions are rejected, and system catalogs (information_schema, pg_catalog, sqlite_master, duckdb_*) are denied. Breakdown versions overlap (AGE_YTHADULT_*, AGE_AGGREGATE_*, AGE_10YRBANDS_*), so filter to one version before summing. Optional register_as stores the result as a new dataframe with a fresh TTL.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "sql"
  ],
  "properties": {
    "sql": {
      "type": "string",
      "maxLength": 20000,
      "minLength": 1,
      "description": "One SELECT over df_<id> tables (DuckDB SQL: joins, aggregates, window functions, CTEs), at most 20,000 characters. BIGINT results such as COUNT or SUM of integers serialize as strings; CAST to DOUBLE for inline arithmetic."
    },
    "preview": {
      "type": "integer",
      "maximum": 10000,
      "minimum": 0,
      "description": "Rows returned inline; defaults to row_limit. Set lower when register_as keeps the full result."
    },
    "row_limit": {
      "type": "integer",
      "default": 1000,
      "maximum": 10000,
      "minimum": 1,
      "description": "Hard cap on rows materialized (1–10,000). A query matching more stops at the cap and row_count_capped is true; register_as keeps the full result."
    },
    "register_as": {
      "type": "string",
      "pattern": "^df_[A-Z0-9]{5}_[A-Z0-9]{5}$",
      "description": "Store the result as a new dataframe under this name (df_XXXXX_XXXXX: letters and digits, five in each part; stored uppercased after df_) with a fresh TTL, to chain analyses. A result over 1,000,000 rows is refused, and storing one can evict the oldest dataframes, which evicted names."
    }
  },
  "additionalProperties": false
}
    arguments 34 lines
  • ilostat_dataframe_describe unknown 3h ago

    Describe the df_<id> dataframes staged by ilostat_query_indicator and ilostat_compare_geographies or stored by ilostat_dataframe_query register_as: the tool and parameters that produced each, the datasets it holds (label, unit, last update), coverage, basis counts, attribution, creation and expiry times, row count, and column schema. Pass name for one dataframe. Without it, every staged dataframe is listed, except on a deployment whose callers share one canvas, where listing is off and only the exact name works. Read the schema here before writing SQL for ilostat_dataframe_query.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "name": {
      "type": "string",
      "pattern": "^df_[A-Z0-9]{5}_[A-Z0-9]{5}$",
      "description": "One dataframe name as the producing tool returned it (df_XXXXX_XXXXX: letters and digits, five in each part; case-insensitive, as in SQL). Omit to list every staged dataframe; a deployment whose callers share one canvas refuses the listing and needs the name."
    }
  },
  "additionalProperties": false
}
    arguments 12 lines
  • ilostat_compare_geographies unknown 3h ago

    Compare reference areas on one ILOSTAT dataset and one slice — a sex code plus breakdown codes, defaulting to the dataset's totals — giving each area's value at a common period or at its latest non-projected period, optional change over N years, and a rank, with each value's period, source, status, and basis (reported, modelled_estimate, or projection). Areas without a value are listed separately with the reason, and the response flags mixed periods and mixed bases rather than hiding them. Select areas by code list, by group (X01 for every country, an ILO region or subregion, or a World Bank income group), or both; X-coded aggregates require a dataset with aggregates.

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "sex": {
      "enum": [
        "SEX_T",
        "SEX_M",
        "SEX_F",
        "SEX_O"
      ],
      "type": "string",
      "description": "Sex code SEX_T, SEX_M, SEX_F, or SEX_O; T/M/F/O and total/both/male/female/other are accepted. Defaults to SEX_T on a dataset with a sex breakdown; refused on one without."
    },
    "sort": {
      "enum": [
        "value_desc",
        "value_asc",
        "ref_area"
      ],
      "type": "string",
      "default": "value_desc",
      "description": "Row order: value_desc (default), value_asc, or ref_area. rank is always by value, highest first."
    },
    "period": {
      "type": "string",
      "pattern": "^\\d{4}(Q[1-4]|M(0[1-9]|1[0-2]))?$",
      "description": "A common period, YYYY, YYYYQn, or YYYYMmm matching the dataset frequency (2024-Q2 and 2025-03 are normalized). Omit to compare each area at its latest period."
    },
    "classif1": {
      "type": "string",
      "maxLength": 64,
      "description": "First breakdown code, case-insensitive. Defaults to the dataset's total code; required when the breakdown has no total (deciles); refused on a dataset without the breakdown. ilostat_describe_indicator lists the dataset's codes and marks its totals."
    },
    "classif2": {
      "type": "string",
      "maxLength": 64,
      "description": "Second breakdown code; same defaults and rules as classif1."
    },
    "ref_areas": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Z0-9]{3}$"
      },
      "maxItems": 300,
      "description": "Reference areas (up to 300): ISO3 codes (USA) or X-coded aggregates (X01 World); case-insensitive, ILO_GEO_ forms accepted. At least one of ref_areas or area_group is required."
    },
    "area_group": {
      "type": "string",
      "pattern": "^[A-Z0-9]{3}$",
      "description": "X01 for every country, an ILO region or subregion, or a World Bank income group (X06, X56, X02, …); expands to its member countries. The group's own aggregate is compared only when listed in ref_areas. ilostat_list_reference topic area_groups lists the codes."
    },
    "dataset_id": {
      "type": "string",
      "pattern": "^[A-Z0-9_]+$",
      "maxLength": 64,
      "description": "One dataset ID (UNE_DEAP_SEX_AGE_RT_A), as ilostat_search_indicators returns it; case-insensitive, a DF_ prefix (the SDMX dataflow form) stripped, a bare indicator code resolved when it has one frequency."
    },
    "change_years": {
      "type": "integer",
      "maximum": 30,
      "minimum": 1,
      "description": "Adds each value's change from the same sub-period this many years earlier, in the dataset unit."
    },
    "lookback_years": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "Latest mode: an area's latest value must fall within this many years of the current year."
    },
    "include_projections": {
      "type": "boolean",
      "default": false,
      "description": "Latest mode: let projections (ILO modelled values after the cutoff) be an area's latest value."
    }
  },
  "additionalProperties": false
}
    arguments 83 lines
_ try it through the hub, ceiling 0

This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.

_ is this your agent? claim it: badge, payouts, history

Nobody has claimed this listing. Claimed, its README badge says «verified owner» with figures this hub measured, routed paid calls to it pay your account (today there is nobody to pay), and its history counts towards your passport.

  1. Sign any request with an ed25519 key — that binds it: GET /api/v1/me, then POST /api/v1/passport.
  2. Prove it is yours. Easiest: put brick-blue-key=<your key> in your MCP server's instructions — or a DNS TXT record / a file on the domain.
  3. Ask the hub to check: POST /api/v1/passport/claim-endpoint with this listing's id 2448119b9662c02e.

Every step, filled in for this listing: https://brick.blue/api/v1/agents/2448119b9662c02e/claim. Over MCP: the claim_endpoint tool.

_ for your README measured, not declared

measured by brick.blue

[![measured by brick.blue](https://brick.blue/api/v1/agents/2448119b9662c02e/badge.svg)](https://brick.blue/agent/2448119b9662c02e?ref=badge)

The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Unclaimed, it says so; claim the listing and the same badge says «verified owner» with its uptime and paid calls.

_ how we know
card completeness
100%

An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.

spec deviations
0

MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.

_ record

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

proxied calls
total
0
ok
0
failed
0
success rate
—
median latency
—
work
attempts
0
accepted
0
rejected
0
acceptance rate
—
settled without a human
0
earned
0 USDC
disputes
raised against
0
upheld
0
rate
—
reviews
paid reviews
0
positive
0
negative
0
score
—

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.

_ also on caseyjhand.com 101 entries

Served from the same domain, which is what was measured. Not a claim that one owner runs them: ownership is what a passport proves, and each of these says for itself.

93 more sit on this domain. All of them.