Add it from Claude's connector directoryRecommended
Start here. Add it inside Claude and sign in with your Twinkle Hub account — no API key to create, and none to paste. The connector is Anthropic verified.
Works in Claude Desktop, on claude.ai and in the mobile apps.
Free allowance, rate limits and how the plans differ are all on the pricing page. When the allowance runs out, the gateway rejects calls until it refills, then resumes on its own — nothing to reset.
Troubleshooting
Every entry below comes from a call that actually failed in production. The message is what you see; underneath is why, and what to do.
Please reconnect to Twinkle Hub…
You called an individual tool name directly (for example tw_search_datasets). This service exposes four tools; individual tools are dispatched through execute_tool.
Call execute_tool instead, with the tool name in tool_id and its parameters in arguments.
Unknown tool_id
That name does not exist — usually an old one. In August 2026 every Taiwan tool gained a tw_ prefix and the old names were not kept.
Use discover_tools, describe the data you want in plain language, and take the current name from the result.
filters[0].field is not a queryable column of this dataset
The field in a filter must be a column that this particular dataset actually has, and the columns differ from dataset to dataset.
Call tw_get_dataset first to see the columns; the error also lists them in details.allowed_columns.
Unrecognised parameter: ['columns']
A parameter name is wrong — commonly columns instead of select, or a name carried over from SQL.
Use the parameter list the error prints; call inspect_tool when you are unsure of a tool's shape.
Out of credits / plan limit reached
Two different situations: credits exhausted (402) waits for the refill or a top-up; a plan limit (409) needs a subscription change or an upgrade.
Read the error code first — 402 and 409 have different fixes, and topping up will not clear a 409.
Semantic search is temporarily paused (reindexing)
Semantic search over judgments pauses occasionally while its index is rebuilt. Keyword search stays available and covers more recent months.
Switch to keyword search: put your terms in jfull_contains, optionally narrowed by court_code and year.
How to remove
Taking a break? The two paths come off differently, so they are listed separately. Your account and API key are not revoked — add it back any time.
Added from Claude's connector directory
Remove Twinkle Hub in Claude's connector settings. That is the Claude side only — it does not necessarily revoke the authorisation held here. To revoke that too, open your account page, find “Connected AI apps” and press Revoke; the app loses access immediately.
If you originally installed by hand-editing claude_desktop_config.json, delete the twinkle-hub entry under mcpServers instead, save, and restart Claude Desktop.
Claude Code
bash
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).