Reader tools

The Reader server (https://clickbase.so/mcp/reader) exposes read-only tools. None of them mutate anything — they are safe for reporting, analytics and Q&A agents. Every tool acts within your current team; a site parameter accepts the site's domain or id.

list-sites-tool

Read-only.

List the current team's sites with their last-24h unique visitors, change versus the previous day, and an hourly sparkline. Optional filters: search (by domain) and sort.

Parameters

Parameter	Type	Required	Description
search	string	No	Case-insensitive match against the site domain.
sort	string	No	One of most_visitors, fewest_visitors, domain_asc, domain_desc (default most_visitors).

Returns — a sites array; each site has id, domain, timezone, created_at, has_data, is_pinned, visitors_24h, change_24h, and sparkline (24 hourly counts).

get-site-overview-tool

Read-only.

Topline analytics for one of the current team's sites over a date range: pageviews, visitors, sessions, views per visit, bounce rate, average session duration, custom events, and (when present) revenue — each with the equivalent previous period for a delta.

Parameters

Parameter	Type	Required	Description
site	string	Yes	The site domain or id.
range	string	No	Preset range: today, yesterday, last_7_days, last_30_days, this_month, last_month, last_12_months, all (default last_30_days). Ignored when from and to are given.
from	string	No	Custom range start, Y-m-d. Requires to.
to	string	No	Custom range end, Y-m-d. Requires from.

Returns — an overview object: pageviews, visitors, sessions, views_per_visit, bounce_rate, avg_session_seconds, custom_events, days, a nested previous period, and (only when either period has revenue) revenue and payments.

list-goals-tool

Read-only.

List the goals defined on one of the current team's sites, ordered by display name. Optionally filter by a case-insensitive display-name search.

Parameters

Parameter	Type	Required	Description
site	string	Yes	The site domain or id.
search	string	No	Case-insensitive match against the goal display name.

Returns — a goals array; each goal has id, display_name, type (event / page / scroll), event_name, page_path, scroll_threshold, currency, custom_props, and created_at.

list-funnels-tool

Read-only.

List the funnels defined on one of the current team's sites, ordered by name, each with its step count.

Parameters

Parameter	Type	Required	Description
site	string	Yes	The site domain or id.

Returns — a funnels array; each funnel has id, name, strict_order, steps_count, and created_at.