Skip to content

Refnusa

by refnusa.dev · remote · no sign-in to list tools · v0.2.0 · published by dev.refnusa

Indonesia reference data: holidays, wages, regions, postal codes, tax, food prices, KBLI, BPS stats

Changes · 6
CompareRegistry entry

33 tools: 6 change things and 27 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http refnusa https://refnusa.dev/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

33 tools

Changes things 6Claude Code: ask
  • calculate_net_salaryEstimated take-home pay from a monthly gross salary: worker BPJS deductions (JHT, JP, JKN), PPh 21 by the PP 58/2023 TER table or the December annual recalculation, and the employe…No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Estimated take-home pay from a monthly gross salary: worker BPJS deductions (JHT, JP, JKN), PPh 21 by the PP 58/2023 TER table or the December annual recalculation, and the employer's own contributions, each line with its decree. Give gross, or regency_code to use that kabupaten/kota UMK. An estimate; the employer payslip decides.
  • check_holidayWhether one date is a public holiday or cuti bersama, with the decree it was checked against.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Whether one date is a public holiday or cuti bersama, with the decree it was checked against. Weekends count only when the decree names them.
  • get_bank_codesThree-digit bank codes (Sandi Bank) of the commercial and sharia banks on the OJK head-office list of June 2026, by code or by part of the bank name; no argument lists all 105.No findings

    Why it is in this group

    • The name "get_bank_codes" says "get": a word for reading.
    • The input takes a statement or command to run (input.code), which can change anything it can reach.
    Description, as the server wrote it
    Three-digit bank codes (Sandi Bank) of the commercial and sharia banks on the OJK head-office list of June 2026, by code or by part of the bank name; no argument lists all 105.
  • get_kbliOne KBLI 2020 entry by code (a letter A to U, or 2, 3, 4 or 5 digits) with its description, its ancestors up to the kategori and its children.No findings

    Why it is in this group

    • The name "get_kbli" says "get": a word for reading.
    • The input takes a statement or command to run (input.code), which can change anything it can reach.
    Description, as the server wrote it
    One KBLI 2020 entry by code (a letter A to U, or 2, 3, 4 or 5 digits) with its description, its ancestors up to the kategori and its children.
  • get_wilayahAdministrative regions: the 38 provinces, the children of one parent code, or one region by code.No findings

    Why it is in this group

    • The name "get_wilayah" says "get": a word for reading.
    • The input takes a statement or command to run (input.code), which can change anything it can reach.
    Description, as the server wrote it
    Administrative regions: the 38 provinces, the children of one parent code, or one region by code.
  • reverse_postal_codeRegions (kelurahan or desa) that carry one postal code.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Regions (kelurahan or desa) that carry one postal code.
Only reads 27Claude Code: allow
  • get_bpjs_ratesBPJS contribution rates as a percent of monthly wage, per program (JHT, JP, JKK, JKM, JKP, JKN), with the decree behind each rate.No findings

    Why it is in this group

    • The name "get_bpjs_rates" says "get": a word for reading.
    Description, as the server wrote it
    BPJS contribution rates as a percent of monthly wage, per program (JHT, JP, JKK, JKM, JKP, JKN), with the decree behind each rate. JKK serves the PP 6/2025 bands; the 2026 JP wage cap is Rp10.547.400 (the BPJS article 18913 says Rp10.547.000, see the row note).
  • get_fao_indonesiaFAOSTAT series for Indonesia: undernourishment, food insecurity, dietary energy and protein supply, and the supply of main staples (rice, wheat, maize, cassava, sugar, vegetable oi…No findings

    Why it is in this group

    • The name "get_fao_indonesia" says "get": a word for reading.
    Description, as the server wrote it
    FAOSTAT series for Indonesia: undernourishment, food insecurity, dietary energy and protein supply, and the supply of main staples (rice, wheat, maize, cassava, sugar, vegetable oils, soyabeans, poultry, eggs, fish). FAO methodology and population estimates, not comparable with BPS figures. Call without series for the list, then with series for the values.
  • get_food_price_seriesMonthly PIHPS Nasional (Bank Indonesia) price series, in Rp/kg, for one province and one staple food from May 2017; each point is the price on the first day of the month with data …No findings

    Why it is in this group

    • The name "get_food_price_series" says "get": a word for reading.
    Description, as the server wrote it
    Monthly PIHPS Nasional (Bank Indonesia) price series, in Rp/kg, for one province and one staple food from May 2017; each point is the price on the first day of the month with data (observed_on). Optional from and to months.
  • get_food_prices_latestLatest PIHPS Nasional (Bank Indonesia) price of a staple food per province, in Rp/kg, on the newest observation day, plus PIHPS national averages.No findings

    Why it is in this group

    • The name "get_food_prices_latest" says "get": a word for reading.
    Description, as the server wrote it
    Latest PIHPS Nasional (Bank Indonesia) price of a staple food per province, in Rp/kg, on the newest observation day, plus PIHPS national averages. Covers the 10 groups and 21 items. Without market you get one row per province and commodity: the traditional-market (tradisional) price when it exists, otherwise the modern-market price; each row names its market and day. Traditional markets report for fewer provinces than modern ones. Pass market for one market only. Filter by commodity, province and market. With month (YYYY-MM): the monthly series price instead, for the 10 groups in traditional markets only.
  • get_fuel_pricesRetail price per litre of the subsidised and special-assignment fuels (Solar, minyak tanah, RON 90) from Kepmen ESDM 218.K/MG.01/MEM.M/2022.No findings

    Why it is in this group

    • The name "get_fuel_prices" says "get": a word for reading.
    Description, as the server wrote it
    Retail price per litre of the subsidised and special-assignment fuels (Solar, minyak tanah, RON 90) from Kepmen ESDM 218.K/MG.01/MEM.M/2022. Non-subsidised fuels are not included.
  • get_het_pricesHarga eceran tertinggi: beras medium and premium by wilayah (Keputusan Kepala Bapanas 299/2025, 22 Aug 2025) and LPG 3 kg in Jawa Timur (Kepgub 801/2024).No findings

    Why it is in this group

    • The name "get_het_prices" says "get": a word for reading.
    Description, as the server wrote it
    Harga eceran tertinggi: beras medium and premium by wilayah (Keputusan Kepala Bapanas 299/2025, 22 Aug 2025) and LPG 3 kg in Jawa Timur (Kepgub 801/2024).
  • get_holidaysPublic holidays (libur nasional) and joint leave days (cuti bersama) for one year, from that year's SKB 3 Menteri decree.No findings

    Why it is in this group

    • The name "get_holidays" says "get": a word for reading.
    Description, as the server wrote it
    Public holidays (libur nasional) and joint leave days (cuti bersama) for one year, from that year's SKB 3 Menteri decree.
  • get_ojol_tariffsRide-hailing motorbike fare limits per zone (per-km lower and upper bound, minimum fare for the first 4 km) from KP 667/2022.No findings

    Why it is in this group

    • The name "get_ojol_tariffs" says "get": a word for reading.
    Description, as the server wrote it
    Ride-hailing motorbike fare limits per zone (per-km lower and upper bound, minimum fare for the first 4 km) from KP 667/2022. A 2026 decision may supersede it; see the dataset note.
  • get_passport_feesImigrasi PNBP fees from PP 45/2024: passport (biasa 5 and 10 years, electronic and non-electronic, SPLP, same-day service) and visa kunjungan (single and multiple trip).No findings

    Why it is in this group

    • The name "get_passport_fees" says "get": a word for reading.
    Description, as the server wrote it
    Imigrasi PNBP fees from PP 45/2024: passport (biasa 5 and 10 years, electronic and non-electronic, SPLP, same-day service) and visa kunjungan (single and multiple trip). Government fee only.
  • get_postal_codePostal codes of one kelurahan or desa by its wilayah code.No findings

    Why it is in this group

    • The name "get_postal_code" says "get": a word for reading.
    Description, as the server wrote it
    Postal codes of one kelurahan or desa by its wilayah code.
  • get_pph21_terPPh 21 effective average rate (TER) bracket for a monthly gross income and TER category A, B or C, per PP 58/2023.No findings

    Why it is in this group

    • The name "get_pph21_ter" says "get": a word for reading.
    Description, as the server wrote it
    PPh 21 effective average rate (TER) bracket for a monthly gross income and TER category A, B or C, per PP 58/2023.
  • get_prayer_timesPrayer times for one kabupaten/kota and date, computed by a documented hisab method; not an official Kemenag feed.No findings

    Why it is in this group

    • The name "get_prayer_times" says "get": a word for reading.
    Description, as the server wrote it
    Prayer times for one kabupaten/kota and date, computed by a documented hisab method; not an official Kemenag feed.
  • get_ptkpAnnual non-taxable income (PTKP) for a taxpayer status such as TK/0 or K/1.No findings

    Why it is in this group

    • The name "get_ptkp" says "get": a word for reading.
    Description, as the server wrote it
    Annual non-taxable income (PTKP) for a taxpayer status such as TK/0 or K/1.
  • get_stat_seriesThe time series of one BPS indicator for one region: a province (2 digits), a kabupaten/kota (5 characters like 32.73, hdi_regency and inflation_yoy_regency only) or 00 for Indones…No findings

    Why it is in this group

    • The name "get_stat_series" says "get": a word for reading.
    Description, as the server wrote it
    The time series of one BPS indicator for one region: a province (2 digits), a kabupaten/kota (5 characters like 32.73, hdi_regency and inflation_yoy_regency only) or 00 for Indonesia.
  • get_stat_valuesOne BPS indicator for one period across all regions in a single call (for a map), plus the national figure.No findings

    Why it is in this group

    • The name "get_stat_values" says "get": a word for reading.
    Description, as the server wrote it
    One BPS indicator for one period across all regions in a single call (for a map), plus the national figure. Period is YYYY or YYYY-MM as listed by list_stat_indicators; omit it for the latest. A bare year on a semester indicator resolves to the latest period in that year.
  • get_tax_ratesTax and duty rates, each with its decree: PPN 12% and the 11/12 DPP (PMK 131/2024), Bea Meterai tariff and threshold (UU 10/2020), and the domestic cukai hasil tembakau table (PMK …No findings

    Why it is in this group

    • The name "get_tax_rates" says "get": a word for reading.
    Description, as the server wrote it
    Tax and duty rates, each with its decree: PPN 12% and the 11/12 DPP (PMK 131/2024), Bea Meterai tariff and threshold (UU 10/2020), and the domestic cukai hasil tembakau table (PMK 97/2024 Lampiran I).
  • get_umkRegency or city minimum wage (UMK) for one year.No findings

    Why it is in this group

    • The name "get_umk" says "get": a word for reading.
    Description, as the server wrote it
    Regency or city minimum wage (UMK) for one year. With regency_code: that kabupaten/kota (default year: its newest). Without it: every kabupaten/kota with a confirmed figure for the year (default: the newest loaded), in one response, optionally limited to one province_code.
  • get_umk_historyEvery loaded year of the regency or city minimum wage (UMK) for one kabupaten/kota, oldest first, each row with its source instrument and URL: a governor decree, or for some region…No findings

    Why it is in this group

    • The name "get_umk_history" says "get": a word for reading.
    Description, as the server wrote it
    Every loaded year of the regency or city minimum wage (UMK) for one kabupaten/kota, oldest first, each row with its source instrument and URL: a governor decree, or for some regions the open-data portal of the regional government (source_instrument then starts with Portal and notes that the dataset has no decree number). Covers Jawa Barat 2023 to 2026, Jawa Tengah 2022 to 2026, Jawa Timur 2024 to 2026, a few Riau and Bali regions for 2024, Kalimantan Barat (2019, 2022, 2025), Banten (2020 to 2024), seven Sumatera Selatan regions (2024), five Kalimantan Timur regions (Berau, Kutai Barat, Kutai Timur, Penajam Paser Utara, Samarinda), six Magelang-area regions 2014 to 2020, Kota Tegal 2021 and Rembang (2010, 2019). Where no decree or portal row exists, BPS provincial tables fill in (source_instrument then starts with BPS table, one amount per year, no decree number or effective date): Sumatera Utara 2015 to 2024, Kepulauan Riau 2016 to 2025, Jawa Tengah 2017 to 2021, Banten 2014 to 2019, Nusa Tenggara Timur 2016 to 2025 (not 2019), Lampung 2017 to 2025, DI Yogyakarta 2016 to 2025, plus UMK 2026 for Nusa Tenggara Timur and 12 Lampung regions.
  • get_umpProvincial minimum wage (UMP) for one year (default: the newest loaded), all provinces or one province.No findings

    Why it is in this group

    • The name "get_ump" says "get": a word for reading.
    Description, as the server wrote it
    Provincial minimum wage (UMP) for one year (default: the newest loaded), all provinces or one province. For 2026, 29 provinces cite the governor decree and 9 the BPS table; 1997 to 2025 rows cite the BPS yearly table (2017 and Jawa Barat 2016: BPS Statistik Indonesia 2018, Tabel 3.2.23).
  • get_ump_historyEvery loaded year of the provincial minimum wage (UMP) for one province, oldest first, each row with its source (governor decree or BPS table) and URL.No findings

    Why it is in this group

    • The name "get_ump_history" says "get": a word for reading.
    Description, as the server wrote it
    Every loaded year of the provincial minimum wage (UMP) for one province, oldest first, each row with its source (governor decree or BPS table) and URL. 1997 to 2026. Without province_code: the same rows for all provinces in one response, ordered by province then year (for charts and bulk analysis).
  • get_zakatBAZNAS RI 2026 zakat figures: fitrah (SK 14/2026) and the nisab and rate of zakat penghasilan dan jasa (SK 15/2026).No findings

    Why it is in this group

    • The name "get_zakat" says "get": a word for reading.
    Description, as the server wrote it
    BAZNAS RI 2026 zakat figures: fitrah (SK 14/2026) and the nisab and rate of zakat penghasilan dan jasa (SK 15/2026).
  • list_datasetsCoverage and status of every dataset: status, row count, source instrument, effective date, publisher, official source URL, last check, data period, cadence, maximum age, next expe…No findings

    Why it is in this group

    • The name "list_datasets" says "list": a word for reading.
    Description, as the server wrote it
    Coverage and status of every dataset: status, row count, source instrument, effective date, publisher, official source URL, last check, data period, cadence, maximum age, next expected update, and the catalogue page. The licence, caveat and fallback fields are Indonesian text.
  • list_food_commoditiesThe 10 staple food groups and their 21 items that PIHPS Nasional (Bank Indonesia) reports per province, with code, Indonesian and English name, unit (Rp/kg), the markets (tradision…No findings

    Why it is in this group

    • The name "list_food_commodities" says "list": a word for reading.
    Description, as the server wrote it
    The 10 staple food groups and their 21 items that PIHPS Nasional (Bank Indonesia) reports per province, with code, Indonesian and English name, unit (Rp/kg), the markets (tradisional, modern) that have a price on the newest day, and for the groups the first and last month of the monthly series.
  • list_stat_indicatorsRegional statistics from BPS tables: the indicator ids with unit, level (province or kabupaten/kota), every period available, source table and caveats.No findings

    Why it is in this group

    • The name "list_stat_indicators" says "list": a word for reading.
    Description, as the server wrote it
    Regional statistics from BPS tables: the indicator ids with unit, level (province or kabupaten/kota), every period available, source table and caveats. Includes unemployment (TPT), poverty and poverty lines, HDI (IPM), wages, population, GRDP per capita, life expectancy and monthly inflation and CPI (inflation_mom, inflation_yoy, inflation_ytd, cpi for provinces; inflation_yoy_regency for CPI cities; periods YYYY-MM from 2024-01, base 2022=100). Start here, then call get_stat_values or get_stat_series.
  • search_kbliSearch the KBLI 2020 business-field classification (Peraturan BPS 2/2020) by part of the title or a code prefix, optionally one of its five levels (kategori, golongan_pokok, golong…No findings

    Why it is in this group

    • The name "search_kbli" says "search": a word for reading.
    Description, as the server wrote it
    Search the KBLI 2020 business-field classification (Peraturan BPS 2/2020) by part of the title or a code prefix, optionally one of its five levels (kategori, golongan_pokok, golongan, subgolongan, kelompok). Returns code, level, parent and title; fetch one code for its description.
  • validate_nikChecks the structure of a 16-digit NIK and looks up its region digits in the wilayah table.No findings

    Why it is in this group

    • The name "validate_nik" says "validate": a word for reading.
    Description, as the server wrote it
    Checks the structure of a 16-digit NIK and looks up its region digits in the wilayah table. Send the NIK in the JSON body; it is never logged.
  • validate_plateChecks the format of an Indonesian vehicle plate and names the region of its prefix when the prefix table is loaded.No findings

    Why it is in this group

    • The name "validate_plate" says "validate": a word for reading.
    Description, as the server wrote it
    Checks the format of an Indonesian vehicle plate and names the region of its prefix when the prefix table is loaded.

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 0.2.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http refnusa https://refnusa.dev/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__refnusa__list_datasets",
      "mcp__refnusa__get_holidays",
      "mcp__refnusa__get_ump",
      "mcp__refnusa__get_ump_history",
      "mcp__refnusa__get_umk",
      "mcp__refnusa__get_umk_history",
      "mcp__refnusa__get_postal_code",
      "mcp__refnusa__get_pph21_ter",
      "mcp__refnusa__get_ptkp",
      "mcp__refnusa__get_prayer_times",
      "mcp__refnusa__get_bpjs_rates",
      "mcp__refnusa__get_fuel_prices",
      "mcp__refnusa__list_food_commodities",
      "mcp__refnusa__get_food_prices_latest",
      "mcp__refnusa__get_food_price_series",
      "mcp__refnusa__get_passport_fees",
      "mcp__refnusa__search_kbli",
      "mcp__refnusa__get_tax_rates",
      "mcp__refnusa__get_ojol_tariffs",
      "mcp__refnusa__get_zakat",
      "mcp__refnusa__get_het_prices",
      "mcp__refnusa__list_stat_indicators",
      "mcp__refnusa__get_stat_values",
      "mcp__refnusa__get_stat_series",
      "mcp__refnusa__get_fao_indonesia",
      "mcp__refnusa__validate_nik",
      "mcp__refnusa__validate_plate"
    ],
    "ask": [
      "mcp__refnusa__check_holiday",
      "mcp__refnusa__get_wilayah",
      "mcp__refnusa__reverse_postal_code",
      "mcp__refnusa__get_bank_codes",
      "mcp__refnusa__get_kbli",
      "mcp__refnusa__calculate_net_salary"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as refnusa. Review it before you use it.