Official MCP server for WireBoard — lets LLM agents (Claude Desktop, Cursor, VS Code, etc.) query your real-time and historical analytics in conversation. Built on the official @wireboard/api
JavaScript SDK.
Install
Claude Desktop (one-click): download wireboard-mcp-0.1.0.mcpb from Releases and double-click it (or Settings → Extensions → Advanced Settings → Install Extension).
npm (for Cursor / VS Code / CLI / CI): npm install -g @wireboard/mcp, then add the Server Config shown above to your MCP client.
Authentication
Requires a WireBoard API token. Mint one at Settings → API with the analytics:read (REST tools) and live:read (live snapshot) abilities.
Tools
| Tool | What |
|---|---|
list_sites | Every site in the account |
get_account | Token-owner identity + abilities |
get_aggregate | Period totals: visitors, pageviews, bounce rate, duration |
get_timeseries | One metric bucketed by hour or day |
get_history | Per-day visitors / returning / pageviews / bounce / duration |
get_breakdown | Top-N by dimension (country, device, browser, referrer, ...) |
get_top_urls | Per-URL metrics with prefix / contains / exact filters |
query_events | Custom event queries with grouping and filtering |
get_live_state | Real-time snapshot (live visitor count, top pages, active sessions) |
list_dimensions | Meta: every dimension, metric, and limit the API supports |
All tools accept natural date ranges: "today", "yesterday", "last 7 days", "this week", "last week", "this month", "last month", or explicit "YYYY-MM-DD..YYYY-MM-DD". UTC.
Rate limiting
The server proactively caps itself at 100 requests/minute (under the API's 120/minute limit) so LLM bursts space themselves out instead of hitting 429s. Override with WIREBOARD_MCP_RATE_PER_MINUTE if needed.
License
MIT — source at github.com/wireboard/mcp.
Server Config
{
"mcpServers": {
"wireboard": {
"command": "npx",
"args": [
"-y",
"@wireboard/mcp"
],
"env": {
"WIREBOARD_TOKEN": "<YOUR_TOKEN>"
}
}
}
}