Twinkle HubTwinkle Hub
Sign in

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

If Codex prints MCP client for twinkle-hub timed out after 30 seconds on first launch, the default 30-second startup timeout isn't enough for the cold start — open ~/.codex/config.toml and add startup_timeout_sec = 60 under the [mcp_servers.twinkle-hub] block. Subsequent launches typically connect in under 5 s and you can lower it back:

text
[mcp_servers.twinkle-hub]
startup_timeout_sec = 60

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
  • 「Search the UK's data.gov.uk for NHS-related datasets and list the 10 newest」→ realestate_land domain
  • 「Pull the US unemployment-rate series from FRED and compare the last five years」→ procurement domain

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

6. Pricing

Coming soon

Core tools are currently free — 50 credits per rolling 5 hours, refilling 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 reserved for the upcoming Pro tier; we'll announce Pro pricing before billing starts.

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.

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