Apa itu Refnusa
Refnusa menyediakan data rujukan resmi Indonesia sebagai API yang bisa dipanggil dari kode atau dari asisten AI. Tidak perlu kunci API dan tidak perlu mendaftar. Setiap dataset menyebut penerbit, tautan sumber, tanggal pemeriksaan terakhir dan apa yang belum dimuat.
Data yang sama tersedia sebagai katalog data dengan unduhan CSV, JSON dan XLSX, sebagai peta upah, grafik dan kalkulator, dan sebagai halaman per daerah seperti UMP dan UMK. Sorotan data merangkum lima temuan, dan umpan Atom mengabarkan perubahan data.
Sambungkan MCP
Refnusa adalah server MCP jarak jauh di https://refnusa.dev/mcp lewat Streamable HTTP, dengan data yang sama seperti REST.
claude mcp add --transport http refnusa https://refnusa.dev/mcpDi Claude.ai, buka Settings, Connectors, lalu Add custom connector dan tempel alamat di atas. Klien MCP lain bisa memakai alamat yang sama di berkas konfigurasinya.
Permintaan pertama
Hari libur nasional 17 Agustus 2026, lewat REST dan tanpa kunci:
curl "https://refnusa.dev/v1/holidays/2026-08-17"Alamat dasar semua rute adalah https://refnusa.dev. Daftar rute lengkap, parameter, contoh dalam cURL, JavaScript dan Python, dan balasan nyata ada di REST reference (bahasa Inggris).
Dataset
Cakupan build ini, dibaca dari /v1/datasets. Dataset yang belum dimuat menjawab dengan 404 yang menyatakannya terus terang, tidak pernah dengan angka tebakan. Dataset upah memuat daftar tahun di kolom years pada /v1/datasets.
| Dataset | Catatan | Status | Baris |
|---|---|---|---|
| Hari libur nasional dan cuti bersama | Hanya tahun 2026 dan 2027 yang dimuat; revisi SKB di tengah tahun baru masuk setelah dokumennya kami baca. | Dimuat | 51 |
| Upah minimum provinsi (UMP) | Angka 1997 sampai 2025 dari tabel BPS tanpa tanggal berlaku; 2026 memakai keputusan gubernur untuk 29 provinsi dan tabel BPS untuk 9. | Dimuat | 38 |
| Upah minimum kabupaten/kota (UMK) | Hanya 139 dari 514 kabupaten/kota punya UMK 2026. Sebagian kabupaten tidak menetapkan UMK; di sana berlaku UMP provinsi. | Sebagian | 139 |
| Kode wilayah administrasi | Nomor Kepmendagri dasar tidak pasti: kepala berkas sumber menyebut 2138/2025, README repositori menyebut 2430/2025. | Dimuat | 91.599 |
| Kode pos per kelurahan dan desa | Dihimpun dari data terbuka cahyadsn; belum diverifikasi ke dokumen resmi Pos Indonesia. | Dimuat | 83.762 |
| Tarif efektif rata-rata PPh 21 (TER) | Tarif efektif bulanan untuk pemotongan, bukan perhitungan pajak tahunan; kategori mengikuti Pasal 2 ayat 4 PP 58/2023. | Dimuat | 125 |
| Penghasilan tidak kena pajak (PTKP) | Angka tahunan menurut PMK 101/2016; perubahan PTKP baru dimuat setelah PMK-nya kami baca. | Dimuat | 12 |
| Jadwal sholat, dihitung | Hasil hitungan, bukan jadwal resmi Kemenag; hanya sudut Subuh 20 derajat bersumber Kemenag, sisanya parameter umum. | Dimuat | 514 |
| Kode wilayah plat nomor kendaraan | Kode Papua mendahului pemekaran provinsi 2022 dan belum dipisah per provinsi baru. | Dimuat | 57 |
| Sandi bank | Lembar kedua berkas OJK menamai sandi 213 berbeda dari lembar pertama; kami memakai lembar pertama. Berkas tidak memuat tanggal terbit. | Dimuat | 105 |
| Harga BBM bersubsidi dan penugasan | Hanya BBM bersubsidi dan penugasan; harga Pertamax dan lainnya per provinsi tidak dimuat karena tanggal berlakunya tidak jelas. | Sebagian | 3 |
| Tarif paspor dan visa kunjungan | Hanya paspor dan visa kunjungan; izin tinggal dan layanan imigrasi lain dalam lampiran tidak dimuat. Tidak ada baris visa on arrival. | Sebagian | 20 |
| Klasifikasi Baku Lapangan Usaha Indonesia (KBLI 2020) | Uraian diambil dari teks PDF; sebagian masih mengandung sisa pemenggalan baris. Revisi dan erata setelah 2020 belum diterapkan. | Dimuat | 2.710 |
| Tarif PPN, bea meterai dan cukai hasil tembakau | Tidak termasuk cukai tembakau impor, cukai barang lain, PPnBM dan pengecualian bea meterai. | Sebagian | 24 |
| Tarif ojek online per zona | Tabel zona tahun 2022; keputusan tarif yang lebih baru belum ditemukan. Tautan katalog menuju beranda JDIH; dokumen ada di setiap baris. | Sebagian | 3 |
| Zakat fitrah dan nisab zakat penghasilan 2026 | Dibaca dari halaman web BAZNAS; teks SK belum ditemukan. Fidyah, nisab zakat mal dan angka BAZNAS daerah tidak dimuat. | Sebagian | 6 |
| Harga eceran tertinggi: beras dan LPG 3 kg | Beras: Kepka Bapanas 299/2025 (22 Agustus 2025) menaikkan HET medium, premium tetap; dibaca dari PDF resmi. | Sebagian | 17 |
| Harga pangan pokok per provinsi (PIHPS Nasional) | Harga provinsi pada satu hari, bukan rata-rata bulanan. Pasar tradisional hanya 12-13 provinsi per jenis pada 14 Okt 2026; Papua sebelum 2022. | Sebagian | 35.587 |
| Iuran BPJS Ketenagakerjaan dan BPJS Kesehatan | Batas upah JP 2026 Rp10.547.400 dari situs BPJS; artikel lain di situs yang sama menulis Rp10.547.000, dan tidak ada keputusan yang menyatakannya. | Dimuat | 20 |
| Statistik wilayah BPS | Periode berbeda per indikator; nasional = kode 00. Inflasi dan IHK bulanan, 2022=100, mulai Januari 2024; Kota Jakarta hanya di angka provinsi. | Sebagian | 33.043 |
| FAOSTAT Indonesia: ketahanan pangan dan neraca pangan | Metodologi FAO berbeda dari BPS; jangan dicampur. Indikator ketahanan pangan adalah rata-rata tiga tahun. Flag FAO: A resmi, E perkiraan, X pihak lain. | Sebagian | 747 |
Batas dan kode galat
Paket gratis tidak punya batas bulanan. Setiap klien boleh mengirim 60 permintaan per menit; lebihnya dijawab 429 dengan header Retry-After.
| Kode | Status | Arti |
|---|---|---|
invalid_parameter | 400 | Parameter kurang atau tidak lolos pemeriksaan. |
bad_json | 400 | Isi permintaan bukan JSON yang sah. |
not_found | 404 | Tidak ada catatan yang cocok. |
dataset_not_loaded | 404 | Dataset di balik rute ini belum dimuat. |
body_too_large | 413 | Isi permintaan lebih dari 64 KB. |
rate_limited | 429 | Klien sudah melewati 60 permintaan dalam semenit terakhir. |
server_error | 500 | Galat tak terduga; bukan karena permintaan Anda. |
Referensi lengkap rute REST, alat MCP dan contoh balasan ada di halaman referensi dalam bahasa Inggris.