Writer tools

The Writer server (https://clickbase.so/mcp/writer) exposes mutating tools. Every tool writes data and acts only within your current team; a site parameter accepts the site's domain or id. Deletes cannot be undone.

create-site-tool

Writes.

Create a new site (property) in the current team for the given domain. Returns the created site.

Parameters

Parameter	Type	Required	Description
domain	string	Yes	The site domain, e.g. example.com. Must be unique within the team. Max 255 chars.
timezone	string	No	IANA timezone for the site's reports (defaults to UTC).

Returns — a site object: id, domain, timezone, currency, tracking_mode, is_public, has_data, created_at.

update-site-tracking-mode-tool

Writes.

Set a site's tracking mode to "cookieless" or "cookie". Returns the updated site.

Parameters

Parameter	Type	Required	Description
site	string	Yes	The site domain or id.
tracking_mode	string	Yes	Either cookieless or cookie.

Returns — the updated site object (same fields as create-site-tool).

update-site-sharing-tool

Writes.

Toggle whether a site's dashboard is publicly shared. Returns the updated site.

Parameters

Parameter	Type	Required	Description
site	string	Yes	The site domain or id.
is_public	bool	Yes	Whether the site dashboard is publicly shared.

Returns — the updated site object.

delete-site-tool

Writes.

Permanently delete one of the current team's sites and queue removal of its analytics events. This cannot be undone.

Parameters

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

Returns — deleted: true and the deleted site's domain.

create-goal-tool

Writes.

Create a goal on one of the current team's sites. Provide EITHER an event_name (custom event goal) OR a page_path (page goal) — exactly one. A scroll_threshold turns a page goal into a scroll goal. Returns the created goal.

Parameters

Parameter	Type	Required	Description
site	string	Yes	The site domain or id.
event_name	string	Conditional	Custom event name. Provide this OR page_path, not both. Max 120 chars; cannot be pageview/engagement.
page_path	string	Conditional	Page path for a page goal, e.g. /pricing. Max 2048 chars.
scroll_threshold	int	No	Scroll depth 0–100 — turns a page goal into a scroll goal.
display_name	string	No	Optional label; derived from the event name or page path when omitted. Unique on the site.
currency	string	No	Currency for a revenue event goal; must match the site's reporting currency.
custom_props	object	No	Map of custom event property name → value (non-scroll goals only).

Returns — a goal object: id, display_name, type, event_name, page_path, scroll_threshold, currency, custom_props, created_at.

delete-goal-tool

Writes.

Delete a goal from one of the current team's sites, cascading into any funnel that uses it as a step. This cannot be undone.

Parameters

Parameter	Type	Required	Description
site	string	Yes	The site domain or id.
goal_id	string	Yes	The id of the goal to delete. A goal not on this site is rejected.

Returns — deleted: true and the goal_id.

create-funnel-tool

Writes.

Create a funnel on one of the current team's sites from an ordered list of 2-8 goal ids (its steps). Returns the created funnel.

Parameters

Parameter	Type	Required	Description
site	string	Yes	The site domain or id.
name	string	Yes	The funnel name (unique within the site).
goal_ids	string[]	Yes	Ordered list of 2–8 goal ids that belong to this site; array position is the step order. No duplicates.
strict_order	bool	No	Whether steps must be completed in the given order (default false).

Returns — a funnel object: id, name, strict_order, goal_ids (ordered), created_at.

update-funnel-tool

Writes.

Update a funnel on one of the current team's sites. Steps are replaced wholesale from goal_ids (array position is the step order). Returns the updated funnel.

Parameters

Parameter	Type	Required	Description
site	string	Yes	The site domain or id.
funnel_id	string	Yes	The id of the funnel to update. A funnel not on this site is rejected.
name	string	No	The funnel name (unique within the site).
goal_ids	string[]	No	Ordered list of 2–8 goal ids that belong to this site; replaces the existing steps.
strict_order	bool	No	Whether steps must be completed in the given order (default false).

Returns — the updated funnel object (with ordered goal_ids).

delete-funnel-tool

Writes.

Delete a funnel from one of the current team's sites. Its steps are removed with it. This cannot be undone.

Parameters

Parameter	Type	Required	Description
site	string	Yes	The site domain or id.
funnel_id	string	Yes	The id of the funnel to delete.

Returns — deleted: true and the funnel_id.