Twinkle HubTwinkle Hub
Sign in
🛠️ Alpha maintenance window: daily 22:00 – 07:00 (Taiwan time / GMT+8). Service may be unstable. Apologies for any disruption.

📌 2026-05-22 added: National exam past-questions semantic search — 64K papers, 320K questions (1 datasets)

View full changelog →

Docs

10-minute setup

Twinkle Hub is an MCP endpoint — any MCP client connects. Pick the path that matches you.

AI userClaude / no codeCLI toolsClaude Code / Copilot CLI / Codex CLIDevelopercurl / SDK / write into your app

1. Get an API key

/login → one-click sign-in with Google or GitHub. First sign-in auto-mints a virtual API key (sk-...). New accounts start at 0 balance — card top-up coming soon.

Install with one CLI command (pick any of 3): choose whichever of the next three sections (Claude Code / GitHub Copilot CLI / Codex CLI) matches your dev environment — one line and you're set. The three CLIs use different syntaxes, so copy the snippet from the matching section.

2. Claude Code (CLI)

Claude Code ships with a claude mcp add command:

text
claude mcp add --transport http twinkle-hub https://api.twinkleai.tw/mcp/ \
  --header "Authorization: Bearer sk-..."

3. GitHub Copilot CLI

GitHub Copilot CLI uses the copilot mcp add command (same --transport http + --header pattern):

text
copilot mcp add --transport http twinkle-hub https://api.twinkleai.tw/mcp/ \
  --header "Authorization: Bearer sk-..."

4. Codex CLI

OpenAI Codex CLI passes the token via an environment variable (different from the --header pattern used by Claude Code/Copilot) — export first, then codex mcp add:

text
export TWINKLE_HUB_API_KEY=sk-...
codex mcp add twinkle-hub --url https://api.twinkleai.tw/mcp/ \
  --bearer-token-env-var TWINKLE_HUB_API_KEY

5. What to ask

Pick one and try (works in English or Chinese):

  • 「Show me Taipei's PM2.5 readings for the last 30 days, and chart the trend」→ environment domain
  • 「List property sales in this district above NT$50M」→ realestate_land domain
  • 「Top 10 government procurement contracts by amount this year」→ procurement domain

/data has the full 19-domain scope and typical questions for each.

6. Pricing

Coming soon

All tools are free during alpha. We'll announce per-tool pricing before billing starts, and existing users get a transition discount window.

All calls are free during alpha. Once billing kicks in, every call's cost shows up on /usage within seconds, and the gateway auto-rejects when the wallet hits zero — no surprise bills.

7. How to remove

Want to pause? Here's how to remove the Twinkle Hub MCP from each client. Your API key isn't revoked — you can re-add it any time.

Claude Code

Claude Code has a one-shot remove command:

text
claude mcp remove twinkle-hub

Want to fully close your account?

The above only disconnects the client; your hub account and API key remain. To fully remove your account + data, go to /account/security and request deletion (72-hour grace period).