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 →

🎉 Free during alpha · sign up now

Taiwan data MCP Hub

MCP is the open protocol for AI agents — Claude, OpenClaw, Hermes, your own agent loop. Twinkle Hub bundles Taiwan data sources behind a single MCP endpoint — set your client up once, AI can query datasets, run SQL, and call tools.

✨ One-paste install

Download Twinkle Hub for Claude Desktop — double-click and you're set

⬇ Download twinkle-hub.mcpb

v0.2.3 · 47 KB · macOS / Windows / Linux

Double-click → paste your API key (from the dashboard) → done.

Also works in Claude Code, GitHub Copilot CLI, OpenAI Codex CLI, curl/SDK. Full install paths in /docs.

🎁 Free during alpha: all tools, no monthly cap, no rate limits (within fair-use).

52,960

Datasets

Layer 1: OpenData

19

Domains

auto-classified

49

TW utility tools

Layer 2: local-first

20

Official Skills

Layer 3: Agent Skills

Compatible with

Twinkle Hub speaks MCP. So does every client below.

  • Claude
  • Gemini
  • OpenAI
  • Ollama
  • Cline

Plus your own — MCP is an open protocol.

Recent updates

The data keeps growing

We sync from ministries and licensed third-party sources every day. The three most recent additions are below.

View full changelog
2026-06-30v1.41.0

🎓 Teacher exam dual corpus — 12,731 qualification questions + 2,421 recruitment questions

datasets

519

  • **📘 Qualification exam (教檢)** — 429 papers / **12,731 questions**, ROC year 094-115 (2005-2026), **97.6% with official answer key**. Covers 5 categories: kindergarten / SEN / gifted / elementary / secondary. Source: National Taiwan Normal University on commission from MOE
  • **📗 Recruitment exam (教甄)** — 90 papers / **2,421 questions**, ROC year 109-115 (last 7 years), 10 cities/counties (focus on Taipei + Central Taiwan Strategic Alliance of 10 counties). Source: each local education bureau
  • New MCP tools: `search_teacher_exam_questions` / `search_teacher_recruit_questions` (semantic search), `search_teacher_exam` / `search_teacher_recruit` (paper metadata filtering), `get_teacher_exam_paper` / `get_teacher_recruit_paper` (full paper + answer key)

Try asking:

  • Any Piaget questions in the qualification exam?
  • Show me the 2024 secondary-school learner-development paper
2026-06-28v1.38.0

🌊 SHP loader + Taipei interactive flood map v4.1

datasets

0

  • **SHP loader infra** (`twopendata/shp.py`) — pure-Python (pyshp + pyproj, no GDAL) SHP reader with auto TWD97 → WGS84 reprojection and Big5/CP950 DBF fallback. Unlocks **478 SHP datasets** for the corpus mirror pipeline long-term
  • **Taipei interactive flood map v4.1** (demo artifact) — 17 functional items **10/10 done**: live reservoir level, rain gauges, river status, shelter map, rainfall scenarios, flood-prone zones, pump stations
  • Defensive detection + warn-log + fallback for mislabelled `.prj` (encountered with `28028 土石流潛勢溪流圖` which ships EPSG:3822 but data is EPSG:3826 TM2)

Try asking:

  • Will my Neihu home flood when there's heavy rain?
  • Where's the closest shelter in Xinyi?
2026-06-27v1.36.0

⚡ 11 realtime API tools — rainfall / reservoirs / rivers / typhoons / alerts

datasets

11

  • **11 new tools** (`rt_*` namespace) — wrap Taiwan's CWA, NCDR, and Water Resources Agency live public APIs so MCP clients can answer realtime questions without dataset queries
  • Weather: `rt_cwa_realtime_rainfall` (10-min weather-station rain), `rt_cwa_24h_rainfall`, `rt_cwa_typhoon_status`, `rt_cwa_radar_image_url`, `rt_cwa_36h_forecast` (county-level)
  • Disasters: `rt_ncdr_active_alerts` (integrated alerts from CWA + WRA + Highway Bureau RSS)

Try asking:

  • What's the current rainfall in Taipei?
  • Feicui Reservoir status right now

Why this exists

Taiwan data is scattered across 100+ portals.
AI app builders don't have time to wire each one.

Twinkle Hub bundles them into a single MCP service: discover datasets, fetch rows, join across tables, pay — all on one endpoint. Phase one is making data.gov.tw excellent; more sources (industry associations, local governments, commercial data) come next.

01

One MCP endpoint

Every source, every domain, every tool under the same URL. Configure your client once.

02

Deterministic billing

Fixed price per tool — no token-based gambling. Prepaid wallet, hard cutoff, no surprise bills.

03

License compliance

Original license metadata is passed through end-to-end so downstream apps don't trip license terms.

04

MCP-native protocol

tools/list / tools/call are native endpoints, not OpenAI tool-calling translated. Claude / OpenClaw / Hermes / Continue / Cline / your own agent loop — same wire format, no SDK, no adapter.

Why Twinkle Hub

Downloading 53,000 datasets is easy. Making them usable to AI is the hard part.

Making Taiwan open data usable to AI isn't a one-off catalog download. We handle the cleanup, conversion, classification, and querying — your AI just calls the API instead of crawling a hundred different portals.

52,960 / 19

53,000 datasets, sorted automatically

All 52,960 datasets on data.gov.tw, sorted into 19 categories. New ones land in the right place the next day — the index never ages out.

10+ formats

All the file formats, one shape

CSV, JSON, Excel, PDF, geo files — whatever the format, we read it and clean up the column names. Your AI doesn't choke just because one source is PDF and another is XLSX.

~50 ms

Ask a question, answer in 50 ms

Want your AI to query data on specific conditions? We have a query layer — about 50 ms across all 53,000 datasets. We don't dump a zip and tell you to process it yourself.

Daily refresh

Synced with the government every day

A daily cron pulls the latest catalog, picks up what's new or retired, runs classification. The data stays fresh — it doesn't go stale because we forgot to update.

Official Skills

Twinkle Hub Skills — Taiwan data, ready to query

20 official Anthropic Agent Skills. Load one into Claude Desktop / Claude Code / GitHub Copilot CLI / OpenAI Codex CLI — or any MCP-compatible agent — and it already knows which tool to call, which filter to use, and what a typical query looks like.

📦 Download all 20 SKILLsUnzip into ~/.claude/skills/ to install
-35%
Total tokens (end-to-end)
End-to-end wall time
-67%
MCP I/O tokens per query
100%
First-call accuracy (11/11)

2026-05-31 internal benchmark — Phase 1 plan-only across 11 skill domains, Claude Opus 4.7 subagent A/B (incl. Round 2 narrow-domain: health/finance/environment/agriculture); Phase 2 real MCP (LVR query: "Taipei Da'an 2024 transactions over NT$50M"). Single-query sample; cold-start and retry costs not included. See full report for caveats.

Judicial Court Decisions

v1.0.0

360+ months · 6M+ cases (1996–)

Semantic search + LLM-extracted winner / outcome / award / sentence.

MOEX National Exams

v1.0.0

64.8k papers · 320k questions

30+ exam types — civil-service, law, judicial, accounting, medical, teacher and more.

TIPO Patents

v1.0.0

280k+ records (since 2018)

Invention / utility / design patent semantic retrieval + IPC classification.

Real-estate (LVR)

v1.0.0

6 metros + 16 counties · since 2012 · sales 4.75M / rentals 726k / pre-sale 554k

Ministry of Interior LVR sales / rentals / pre-sale lookups; address search via the half-width column.

Government Procurement (PCC)

v1.0.0

162k+ records · 11 years since 2015-04

Nationwide tender / award notices — vendor due diligence and agency spend analysis with one SQL.

Legislative Yuan

v1.0.0

284k+ rows · 8 collections

Bills / legislators / interpellations / IVOD / gazette across 8 linked collections.

Taiwan Transportation

v1.0.0

Main transit batch datasets

TRA / THSR / metro / bus / freeway — main batch datasets (real-time data via TDX tools).

Healthcare

v1.0.0

~1k+ datasets · pandemic / clinics / drug coverage / food safety

NHI, CDC, TFDA, HPA, Chinese medicine, mental health — one umbrella query.

Finance & Securities

v1.0.0

~2k+ datasets · listed companies / FX / customs / tax

FSC, TWSE, TPEx, TDCC, Central Bank, Ministry of Finance from a single skill.

Environment & Weather

v1.0.0

~2k+ datasets · AQI / reservoirs / typhoons / quakes / EIA

MoENV, CWA, Water Resources, Forestry, Ocean Affairs — real-time also via NCHC IoT API.

Agriculture

v1.0.0

~1.5k+ datasets · wholesale prices / fisheries / livestock disease

MOA + its 7 regional improvement stations + tea/forestry research institutes.

Education

v1.0.0

~3k+ datasets · 12k+ schools / admissions / 108 curriculum / teacher exams

MOE + K12EA + Higher Ed + Technical-Vocational + Sports + national universities all together.

Labor & Wages

v1.0.0

~1k+ datasets · wages / unemployment / labor insurance / minimum wage / migrant workers

MOL, BLI and DGBAS wage / unemployment / labor insurance data.

Energy & Utilities

v1.0.0

~700 datasets · oil/gas/electricity / renewables / mix / carbon intensity / plants

Energy Bureau + Taipower + CPC + water utilities in one query path.

Culture & Heritage

v1.0.0

~2.5k+ datasets · monuments / collections / arts events / grants / 16 indigenous peoples

Ministry of Culture, NPM, national museums, Hakka and Indigenous councils.

Population & Elections

v1.0.0

~1k+ datasets · population / births / deaths / elections / new residents

Household Registration, CEC, SFAA, NIA — demographic and electoral data.

Taipei City Data

v1.0.0

165 datasets · OGDL v1 · monthly cron sync

Flood-prone zones, Feicui Reservoir live status, 17,408 stormwater drain segments, 12 district shelter maps.

Tourism & Parks

v1.0.0

~1k+ datasets · 9 national parks / 13 scenic areas / visitor flow

Tourism Administration, National Parks, municipal tourism bureaus — 50k+ POIs with lat/lon.

Tourism Statistics

v1.0.0

37 datasets · 70-yr time series · monthly + yearly

Inbound/outbound travelers, cruise passengers, scenic spots — 70-year monthly time series since 1956.

Geo / GIS

v1.0.0

5k+ datasets with lat/lon

Administrative districts, school zones, electoral districts, public facilities — geocode-ready.

OpenData General

v1.0.0

53k+ datasets · 17 domains

Catalog-wide fallback — for domains the other 9 specialized skills don't cover.

Skill Navigator

v1.0.0

meta · cross-skill routing

Meta-skill: the entry point for agents new to Twinkle Hub — routes you to the right specialized skill.

Who it's for

Three roles, three paths

Ready to plug Taiwan data into your AI?

Free during alpha — no usage cap.

Get started