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.

Just paste the prompt below into Claude Desktop — it'll edit your config:

Add Twinkle Hub to my Claude Desktop. Edit
~/Library/Application Support/Claude/claude_desktop_config.json
(Windows: %APPDATA%\Claude\claude_desktop_config.json).

Merge in this block:
{
  "mcpServers": {
    "twinkle-hub": {
      "type": "http",
      "url": "https://api.twinkleai.tw/mcp/",
      "headers": {
        "Authorization": "Bearer <I'll paste from https://hub.twinkleai.tw/dashboard>"
      }
    }
  }
}

If an mcpServers block already exists, merge — don't overwrite.
Then ask me to restart Claude and list the 5 new opendata-* tools.

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.

Cursor uses ~/.cursor/mcp.json with the same shape as Claude Desktop:

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

After saving, in Cursor: Settings → MCP → reload Twinkle Hub.

Claude Code ships with a claude mcp add command:

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

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.

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.

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.

Cursor

Cursor → Settings → MCP, find the twinkle-hub server and click delete (or toggle off).

Claude Code

Claude Code has a one-shot remove command:

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