MCP server

Refnusa Official

dev.refnusa/refnusa

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

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

Website

At a glance

Type

MCP server

Publisher

refnusa.dev (verified by the MCP Registry)

Status

Working at last check

Tools

33

Token cost

About 5,561 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.refnusa]
url = "https://refnusa.dev/mcp"

Gemini CLI

{"mcpServers":{"refnusa":{"httpUrl":"https://refnusa.dev/mcp"}}}

Cursor

{"mcpServers":{"refnusa":{"url":"https://refnusa.dev/mcp"}}}

VS Code

{"servers":{"refnusa":{"type":"http","url":"https://refnusa.dev/mcp"}}}

Antigravity

agy mcp add refnusa https://refnusa.dev/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"refnusa","server_url":"https://refnusa.dev/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"refnusa","server_url":"https://refnusa.dev/mcp"}

Tools

• calculate_net_salary ~492 tokens
  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 estimat
• check_holiday ~95 tokens
  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_codes ~125 tokens
  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_bpjs_rates ~172 tokens
  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_indonesia ~164 tokens
  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 wit
• get_food_price_series ~254 tokens
  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_latest ~544 tokens
  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,
• get_fuel_prices ~120 tokens
  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_prices ~137 tokens
  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_holidays ~96 tokens
  Public holidays (libur nasional) and joint leave days (cuti bersama) for one year, from that year's SKB 3 Menteri decree.
• get_kbli ~94 tokens
  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_ojol_tariffs ~117 tokens
  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_fees ~142 tokens
  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_code ~86 tokens
  Postal codes of one kelurahan or desa by its wilayah code.
• get_pph21_ter ~120 tokens
  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_times ~144 tokens
  Prayer times for one kabupaten/kota and date, computed by a documented hisab method; not an official Kemenag feed.
• get_ptkp ~79 tokens
  Annual non-taxable income (PTKP) for a taxpayer status such as TK/0 or K/1.
• get_stat_series ~151 tokens
  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_values ~166 tokens
  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_rates ~158 tokens
  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_umk ~221 tokens
  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_history ~396 tokens
  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
• get_ump ~180 tokens
  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_history ~150 tokens
  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_wilayah ~170 tokens
  Administrative regions: the 38 provinces, the children of one parent code, or one region by code.
• get_zakat ~123 tokens
  BAZNAS RI 2026 zakat figures: fitrah (SK 14/2026) and the nisab and rate of zakat penghasilan dan jasa (SK 15/2026).
• list_datasets ~109 tokens
  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_commodities ~117 tokens
  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_indicators ~177 tokens
  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
• reverse_postal_code ~74 tokens
  Regions (kelurahan or desa) that carry one postal code.
• search_kbli ~207 tokens
  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_nik ~92 tokens
  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_plate ~89 tokens
  Checks the format of an Indonesian vehicle plate and names the region of its prefix when the prefix table is loaded.

Browse

• Government and public data

Related MCP servers

• TidyData Tools
  Holidays, business days, currency, time zones, DNS/WHOIS, web page checks, geodata and text tools.
• Afriref: cited government reference data
  Cited official data: tax, VAT, CPI, policy rates, wages, holidays, FX. 128 countries+EU, 7 regions.
• euroref — European government reference data
  European govt data, cited: rates, VAT, tax, wages, holidays, FX. 34 countries + EU; Germany free.
• Reference Data
  Oceania govt data, cited: rates, VAT, tax, wages, holidays, FX. 8 countries; Australia free.
• Postal Codes
  Postal code lookup with place names and coordinates for 60+ countries. Via Zippopotam.us.
• Reference Data
  Asian govt data, cited to source: rates, VAT, tax, wages, holidays, FX. 28 countries; Japan free.
• Reference Data
  LatAm govt data, cited to source: rates, VAT, tax, wages, holidays, FX. 22 countries; Brazil free.
• Reference Data
  Mid-East govt data, cited to source: rates, VAT, tax, wages, holidays, FX. 9 countries; UAE free.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/dev.refnusa/refnusa.svg)](https://aptlynx.net/servers/dev.refnusa/refnusa)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents