What agents cannot do (Clicky limits)
The Clicky API (and the MCP server that fronts it) is read-only by design. Both key types only ever grant read access. This page is the list of things you cannot do programmatically, and the human action to take instead. Trying to force any of these through the API will just produce errors or silently do nothing.
Cannot do
- Add or remove sites. Site registration is human-only. The user does this from user homepage -> sub-users.
- Add or remove users. User registration is human-only. The user does this from their user homepage > add new site.
- Change site settings. Timezone, language, etc. From their user homepage, they should scroll to the site in question and click the "prefs" link for it.
- Create or edit goals, campaigns, or custom events. Goals are defined in the dashboard. (Custom-event data can be written, but only by the tracking code running on the user's site, see custom tracking, never through the API.)
- Generate tracking data. No endpoint accepts visitor data. Anything claiming to is the on-page tracking script's job.
- Manage the account. Billing, plan changes, password, userkeys: dashboard only, via the user.
When the user asks for one of these, don't hunt for an endpoint and don't retry-loop. Just tell them exactly what to click. Note that anything requiring authentication will redirect you to the login page, so don't panic if you're not authenticated, because the user will be.
Gotchas
- Empty report != broken code. This is often a plan limit or the result of just not traffic that day. Free accounts are limited to 30 days of history and 100 results per request. Check the account's plan before rewriting your query, and if the data genuinely is beyond the retention window, tell the user; the upgrade page is /user/upgrade.
- Rate limits: visitors-list, actions-list, and segmentation are capped (see the IMPORTANT box on /help/api), and repeated failed auth attempts lock the key out for 15 minutes. Fix the key, don't retry.
- Deprecated/renamed types may return nothing. If a type documented in your training data returns an empty result consistently, cross-check against the current type list before concluding there's no data.
📢 Want clearer, faster analytics?
Sign up for Clicky today and see your data differently