Twinkle HubTwinkle Hub
Sign in

📌 2026-06-30 added: 🎓 Teacher exam dual corpus — 12,731 qualification questions + 2,421 recruitment questions (519 datasets)

View full changelog →

Lookup MOI admin code

twtools-lookup_admin_code

TW-specificMIT

縣市 [+ 鄉鎮市區] → 內政部 8 碼法定行政區代碼 (sub-ms in-process).

Args:
    county: 縣市名 e.g. '臺北市' / '新北市' / '宜蘭縣'
            (台/臺 兩種寫法都接受, auto normalise)
    town: 鄉鎮市區名 e.g. '信義區' / '羅東鎮' (空字串=只查 county)

Returns:
    {found, county, town, county_code (5-digit e.g. '63000'),
     town_code (8-digit e.g. '63000020')}

Use case: 把含 (city, 鄉鎮市區) 的 dataset row 補上 admin code
          → cross-dataset JOIN with stats / 健保 / 房價 datasets.

Mapping coverage: 全國 22 縣市 368 (county, town) pairs, OGDL v1.

Input schema

{
  "properties": {
    "county": {
      "title": "County",
      "type": "string"
    },
    "town": {
      "default": "",
      "title": "Town",
      "type": "string"
    }
  },
  "required": [
    "county"
  ],
  "title": "lookup_admin_codeArguments",
  "type": "object"
}

How to call

Once your Twinkle Hub MCP client is configured, your agent will see twtools-lookup_admin_code. Just ask it to call — example:

# Ask Claude / any MCP client:
請用 twtools-lookup_admin_code 處理 "…"。

# It will call:
twtools-lookup_admin_code(input="…")

Haven't set up a client yet?

Claude Desktop in 3 minutes — download the .mcpb and double-click, or see docs for other clients.

See user docs