get_account
Get the team-owner identity (email, name) and the abilities of the token in use. Useful for verifying which account the MCP is connected to.
LABSCO SUMMARY
Read-only by construction, and list_dimensions means the model does not have to guess the schema.
The natural date ranges are what make this pleasant in conversation — "last week" is accepted directly, so a question does not need translating into timestamps first. list_dimensions is the quiet essential: it tells the model which dimension keys exist instead of letting it invent one. The server also paces its own request rate, so a burst of model-driven calls spaces itself out rather than failing.
What it is
The official MCP server for WireBoard, a web-analytics product. Read-only tools cover period totals, time series, per-day history, breakdowns by dimension, per-URL metrics, custom events and a live snapshot.
What you get
- list_sites for every site in the account, and get_account for which account the token belongs to and what it may do
- get_aggregate for period totals: visitors, pageviews, bounce rate and visit duration
- get_timeseries for one metric bucketed by hour or day, and get_history for a per-day breakdown including returning visitors, in a single call
- get_breakdown for top rows by dimension — country, device, browser, referrer and the rest
- get_top_urls for per-URL metrics with prefix, contains and exact filters
- query_events for custom events, filtered by category, action, label or campaign fields, and grouped by any combination of them
- get_live_state for the real-time picture: live visitor count, the pages being viewed now, current referrers and active sessions
- list_dimensions as a self-discovery tool, listing every dimension, metric and limit the API supports
- Natural date ranges — today, last week, this month, or an explicit range — accepted by every tool
Requirements
A WireBoard API token minted in your dashboard, with the analytics read ability for the historical tools and the live read ability for the real-time one. Either install the desktop extension, which stores the token in your operating system's keychain, or install the package and put the token in your client config. The package route needs Node.
Setup effort
One command plus a key — npm install -g @wireboard/mcp, then supply credentials
USE CASES
01
Answering how a site did last week
Ask for period totals with a natural date range; no timestamps to convert.
02
Finding where the traffic came from
Pull the top rows for the referrer dimension over the window you care about.
03
Finding the worst pages in one section
Filter per-URL metrics to a path prefix and pick out the worst bounce rates.
04
Attributing conversions to a campaign
Query the custom events filtered by campaign fields and grouped however you need them.
05
Seeing what is happening right now
Read the live snapshot: current visitors, the pages they are on, and where they came from.
06
Plotting a trend
Get one metric bucketed by hour or day, or the full per-day breakdown in a single call.
07
Asking a question when you do not know the dimension key
List every dimension, metric and limit the API supports, then ask again.
10 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get_aggregate
Period totals for one site: visitors, pageviews, bounce_rate, visit_duration. Use this for 'how many visitors did site X get in date range Y' style questions.
get_breakdown
Top-N rows by one dimension (country, device, browser, url, etc.). Use for 'top countries last week', 'most-used browsers', 'top referrer sources'. The dimension determines which field appears in each row alongside the visitor count.
get_history
Per-day breakdown with visitors, returning_visitors, pageviews, bounce_rate, and avg_duration in a single call. Use when the user wants a 'daily report' or wants returning-visitor comparisons. Returns one row per UTC day in the range.
get_live_state
Current real-time snapshot for a site: live visitor count, top pages right now, current top referrers, active sessions, etc. Use for 'what's happening on the site right now', 'who's currently on the checkout page', 'how many visitors live'.
get_timeseries
One metric bucketed over time (hour or day). Use for 'plot pageviews per day this month' or 'visitors per hour today'. Returns an array of {time, value} points.
get_top_urls
Per-URL metrics (visitors, pageviews, bounce_rate, avg_duration) with optional filtering. Use for 'top pages under /blog', 'find the homepage's stats', 'which checkout pages have the worst bounce rate'. Paginated via limit and offset.
list_dimensions
Lists every dimension, metric, and limit the API supports. Use as a self-discovery tool when the user asks something like 'what can you tell me about my analytics' or when you're unsure which dimension key to pass to get_breakdown.
list_sites
List every site in the WireBoard account. Returns each site's ID, domain, and peak-concurrent-visitors over the last 30 days. Call this first if you don't know which site_id to use for the other tools.
query_events
Query custom events (purchases, form submits, button clicks, etc.). Filter by category/action/label or UTM fields, group by any combination of those, paginate. Use for 'how many Purchase events from utm_source=newsletter last week' or 'top event categories this month'.
BEFORE YOU INSTALL
What to know first
Tools you get
10 tools when we connected. All tools read. The nine REST tools need the analytics:read ability and get_live_state needs live:read; a token without them still lists the tool but refuses the call.
Requires
WIREBOARD_TOKEN in your environment
CONTEXT COST
Light Standing cost
Rated by the size of the 10 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npm install -g @wireboard/mcpMCP Clients
Claude Desktop — extension
Download wireboard-mcp-x.y.z.mcpb from the GitHub releases page and double-click it
Claude Desktop — npm, Cursor — npm
JSON
{
"mcpServers": {
"wireboard": {
"command": "wireboard-mcp",
"env": {
"WIREBOARD_TOKEN": "<YOUR_WIREBOARD_TOKEN>"
}
}
}
}VS Code — npm
VS CODE — NPM · JSON
{
"servers": {
"wireboard": {
"command": "wireboard-mcp",
"env": {
"WIREBOARD_TOKEN": "<YOUR_WIREBOARD_TOKEN>"
}
}
}
}
