10-minute setup

/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.

We package Twinkle Hub as a Claude Desktop one-click installer (`.mcpb`) — download → double-click → paste your sk-... key → done. No editing of claude_desktop_config.json required.

Double-click the downloaded twinkle-hub.mcpb. Claude Desktop opens an install dialog, asks for your API key (grab it from the dashboard), and you're done.

Prefer manual config editing? The Claude Desktop section below still has those steps.

Want to edit by hand? Open this file:

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "twinkle-hub": {
      "type": "http",
      "url": "https://api.twinkleai.tw/mcp/",
      "headers": {
        "Authorization": "Bearer sk-..."
      }
    }
  }
}

Replace sk-... with the key you see on your dashboard. Restart Claude — the 5 opendata-* tools will appear.

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.

Calls draw from your 50 credits per rolling 5 hours, which refill gradually (plus a 500-credit weekly cap). On the Free tier, query_rows returns up to 10 rows per call. Advanced semantic search and full-document retrieval are Pro-only. Once your credits run out the gateway rejects calls until they refill.

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 Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (Windows: %APPDATA%\Claude\claude_desktop_config.json), delete the twinkle-hub entry under mcpServers, save, and restart Claude Desktop.

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).