Twinkle HubTwinkle Hub

10-minute setup

Twinkle Hub is an MCP endpoint. Pick the tool you use and follow the steps.

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.

Add Twinkle Hub in Claude

Prefer to hold your own key, or connecting a client other than Claude? Keep reading.

Claude Code (CLI)

Claude Code ships with a claude mcp add command:

Sign in and your key appears here, already filled into every snippet below.

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

Pricing

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