# Refnusa

> Refnusa is a free MCP server for legal and government. Sourced Indonesian reference data: holidays, wages, regions, tax tables and bank codes. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API
- **Website:** https://refnusa.dev
- **MCP Registry name:** dev.refnusa/refnusa
- **Categories:** legal and government, analytics and data
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://refnusa.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/refnusa
