Monstarx Indonesia MCP (Free Sources First)

Separate Indonesia MCP service for public data that requires no account and no API key.

This is the Indonesia counterpart to Monstarx Japan MCP.

Free sources included

Source	Agency	Auth	Tools
BMKG prakiraan cuaca	Badan Meteorologi, Klimatologi, dan Geofisika	None	Weather areas/overview/warnings
Open-Meteo Forecast / Air Quality / Elevation	Open-Meteo	None	24h/4day weather, rain, temp, humidity, UV, air quality, elevation
BMKG Data Gempabumi	BMKG InaTEWS	None	Earthquake list, tsunami potential
Nominatim	OpenStreetMap	None	Address search, geocode, reverse geocode
CariKodePos	CariKodePos.ID	None	Postal code lookup
Nager.Date	Nager.Date	None	Public holidays
Frankfurter BI provider	Bank Indonesia via Frankfurter	None	USD/IDR and other FX series
HDX CKAN	OCHA / HDX	None	Dataset search, metadata, datastore query
OpenStreetMap Overpass	OpenStreetMap contributors	None	Tourism spots, evacuation shelters, nearby hospitals/clinics
API Wilayah Indonesia	EMSIFA / Kemendagri codes	None	Provinces, kabupaten/kota, kecamatan, desa
Berita Indo API	Indonesian news RSS	None	CNN/CNBC/Detik/Kompas/Tempo/Republika headlines, category, search
Comuline API	Community KAI Commuter mirror	None	KRL stations and schedules
KPU SIREKAP storage	Komisi Pemilihan Umum	None	2024 presidential archive only
Local NIK parser	Kemendagri digit layout	None	16-digit NIK format decode (not Dukcapil)
KBBI Open API	Kamus Besar Bahasa Indonesia	None	Dictionary lookup
MyQuran API v2	Kemenag prayer times	None	City search, monthly prayer schedule
EQuran.id	EQuran.id	None	Quran surah list and verses
PetaBencana.id	PetaBencana	None	Jakarta flood reports
Logam Mulia API	Community Antam listings	None	Gold sell/buyback prices
MyQuran husna/hadits	MyQuran	None	Asmaul Husna, hadith
API Hari Libur	National holidays + cuti bersama	None	Cuti bersama calendar
Indonesia Public Static API	yogski	None	Volcanoes, national heroes
Seme Bank ID	OJK bank directory	None	Bank search
OJK Invest API	Unofficial OJK lists	None	Illegal vs legal investments
Indodax Public REST	Indodax	None	Crypto tickers
Doa Harian API	Community doa list	None	Daily doa

Not included (need keys / sandboxes)

BPS Web API, RajaOngkir, BinderByte, SATUSEHAT FHIR, SNAP BI / Midtrans / Xendit / Duitku, Bapanas Web API, MAGMA official REST, KAI stations2 (POST-only booking route), Dayoff API (HTTP 402), Indiwtf (token), data.go.id CKAN (not a stable public endpoint), Pasal.id / BPJS / GoAPI (signup keys), and HTML-only portals (fuel, crime, SIPP, PLN). The GitHub dump sometimes cited as a Kemenkes faskes GeoJSON is not a live public JSON feed; nearby facilities use OpenStreetMap instead.

Endpoints

Path	Purpose
`GET /`	Server info + tool list
`GET /health`	Health check
`POST /mcp`	MCP Streamable HTTP

Environment	MCP URL
Local	`http://localhost:8787/mcp`
Staging	`https://id-mcp-staging.monstarxapp.com/mcp`
Production	`https://id-mcp.monstarxapp.com/mcp`

npm run deploy:staging      # Worker + route id-mcp-staging.monstarxapp.com
npm run deploy:production   # Worker + route id-mcp.monstarxapp.com
npm run smoke staging       # smoke against staging /mcp
npm run smoke:local         # smoke against local wrangler dev

Tools

Tool	Purpose
`id_weather_areas`	List starter BMKG adm4 village codes
`id_weather_overview`	Daily / next-hours overview text
`id_weather_week_overview`	BMKG 3-day overview
`id_weather_warnings`	Severe weather slots from BMKG forecast
`id_weather_24h`	24-hour hourly forecast
`id_weather_4day`	4-day daily forecast
`id_uv_index`	Hourly UV index
`id_rainfall`	Hourly rainfall
`id_air_temperature`	Hourly air temperature
`id_relative_humidity`	Hourly relative humidity
`id_air_quality`	Hourly air quality (PM2.5 etc.)
`id_earthquake_list`	Recent earthquakes
`id_tsunami_list`	Recent tsunami-potential events
`id_postal_code`	Postal code → address
`id_public_holidays`	Indonesia public holidays
`id_elevation`	Elevation at lat/lon
`id_bi_finance`	Bank Indonesia FX via Frankfurter
`id_disease_reports`	Search infectious-disease open datasets
`id_evacuation_shelters`	Nearby evacuation / assembly points
`id_tourism_spots`	Nearby tourism spots (OpenStreetMap)
`id_address_search`	Search Indonesian addresses
`id_geocode`	Address → latitude/longitude
`id_reverse_geocode`	Latitude/longitude → address
`id_datasets_search`	Search HDX Indonesia open datasets
`id_dataset_show`	Dataset metadata + resource URLs by id/name
`id_dataset_metadata`	Alias of `id_dataset_show`
`id_dataset_query`	Query tabular datastore records by resource_id
`id_provinces`	List 38 provinces
`id_regencies`	Kabupaten/kota by province_id
`id_districts`	Kecamatan by regency_id
`id_villages`	Desa/kelurahan by district_id
`id_news`	Latest headlines by source
`id_news_category`	Headlines for a source category (CNN nasional, etc.)
`id_news_search`	Search headlines by title/snippet
`id_krl_stations`	KAI Commuter station list (Comuline)
`id_krl_schedule`	KRL departures for a station id (MRI, GMR, …)
`id_kpu_election_2024`	2024 presidential archive (not a live election)
`id_parse_nik`	Decode 16-digit NIK format (not Dukcapil)
`id_faskes`	Nearby hospitals/clinics (OpenStreetMap)
`id_kbbi`	Indonesian dictionary lookup
`id_prayer_cities`	Search prayer-time city ids
`id_prayer_schedule`	Monthly sholat timetable
`id_quran_list`	List 114 surahs
`id_quran_surah`	Surah text (AR/Latin/ID)
`id_flood_reports`	Jakarta flood reports
`id_gold_price`	Antam / logam mulia sell and buyback
`id_asmaul_husna`	99 names of Allah
`id_cuti_bersama`	National holidays + cuti bersama
`id_volcanoes`	Indonesian volcano catalog
`id_heroes`	National heroes
`id_banks`	Bank directory search
`id_ojk_invest`	Illegal / legal investment check
`id_indodax_ticker`	Indodax public crypto ticker
`id_hadith`	Hadith by narrator + number
`id_doa`	Daily doa (AR/Latin/ID)

Local development

npm install
npm run dev

No .dev.vars or API keys are required for the free sources above.

Checks

npm run typecheck
npm test
npm run check

Smoke test (local)

With npm run dev running:

npm run smoke:local

Example curl

curl http://localhost:8787/mcp \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d "{\"jsonrpc\":\"2.0\",\"method\":\"tools/call\",\"id\":1,\"params\":{\"name\":\"id_weather_overview\",\"arguments\":{\"area_code\":\"31.71.03.1001\"}}}"

curl http://localhost:8787/mcp \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d "{\"jsonrpc\":\"2.0\",\"method\":\"tools/call\",\"id\":2,\"params\":{\"name\":\"id_reverse_geocode\",\"arguments\":{\"latitude\":-6.175392,\"longitude\":106.827153}}}"

curl http://localhost:8787/mcp \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d "{\"jsonrpc\":\"2.0\",\"method\":\"tools/call\",\"id\":3,\"params\":{\"name\":\"id_datasets_search\",\"arguments\":{\"query\":\"earthquake\",\"rows\":3}}}"

Architecture

AI client
  → POST /mcp
  → id_* tools
  → BMKG / Open-Meteo / Nominatim / HDX / Wilayah / Comuline / KPU 2024 archive / news / KBBI / gold / OJK / OSM faskes (no keys)
  → normalized JSON response

Same Worker shell as Japan MCP. Only adapters and tools differ.