Skip to content
MCP server

Refnusa

Sourced Indonesian reference data: holidays, wages, regions, tax tables and bank codes

Install
Pricing
Free
Platforms
API
Runs
Remotely
Version
0.2.0
Listing updated
1 day ago

About Refnusa

Refnusa is a free MCP server for legal and government. It runs as a hosted remote server, so there is nothing to install locally.

Each record from this server names the regulation it came from and the date that regulation took effect, and a dataset that is not loaded yet answers with a plain 404 rather than a guessed figure. That makes it a reference layer for agents that need Indonesian facts they should not make up.

The datasets cover public holidays and joint leave from the annual three-minister decree, provincial minimum wages for all 38 provinces, regency and city minimum wages (139 of 514 loaded, so partial), administrative region codes down to kelurahan, postal codes, PPh 21 effective average tax rates, non-taxable income, computed prayer times, vehicle plate prefixes, OJK bank codes, subsidised fuel prices and immigration fees. The registry entry also mentions KBLI and BPS statistics.

There is no key and no sign-up; the same data is reachable over REST. Add it to Claude Code with a single claude mcp add command.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://refnusa.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "refnusa": {
      "url": "https://refnusa.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

Cited records
Every row names its source regulation, effective date and a link.
Holidays and leave
National holidays and joint leave days from the yearly ministerial decree.
Minimum wages
Provincial figures for all 38 provinces and city or regency figures where loaded.
Region and postal codes
Administrative codes from province to kelurahan, plus postal codes.
Tax tables
PPh 21 effective average rates and non-taxable income thresholds.
Honest gaps
Datasets not yet loaded return a 404 that says so.

Good for

  • Check whether a date is an Indonesian public holiday
  • Look up the minimum wage for a province or regency
  • Validate or resolve a kelurahan and postal code
  • Compute withholding using the published PPh 21 tables
  • Resolve a bank code or a vehicle plate prefix

Pricing

Free

No key or sign-up required

Prices change. Check refnusa.dev before you buy.

Refnusa FAQ

Do I need an API key?

No. The quickstart says there is no key and no sign-up.

How complete is regency minimum wage data?

It is partial: 139 of 514 kabupaten and kota are loaded.

Can I use it without MCP?

Yes, the same data is available over a REST API.

What happens if a dataset is missing?

The server returns a 404 that says it is not loaded, never a guessed figure.

Is Refnusa free?

Yes. Refnusa is free to use.

How do I add Refnusa to Claude Code?

Run this command in your terminal: claude mcp add --transport http refnusa https://refnusa.dev/mcp

What are the best alternatives to Refnusa?

The closest alternatives to Refnusa are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

Alternatives to Refnusa

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data
  6. New York LLC publication rules, deadline, county prices, clerks and notice text

    • 8 tools
    • Remote
    • Free
    • Legal and government