WireBoard

What is WireBoard?

WireBoard is an MCP server that enables LLM agents (Claude Desktop, Cursor, VS Code, etc.) to query real-time and historical analytics in natural language conversation. It integrates with the WireBoard analytics platform via the official @wireboard/api JavaScript SDK.

How to use WireBoard?

Install via the one-click .mcpb release for Claude Desktop or globally via npm install -g @wireboard/mcp for other clients. Authentication requires a WireBoard API token with analytics:read and live:read abilities, minted from the WireBoard dashboard. After setup, add the server config to your MCP client to start using the tools.

Key features of WireBoard

• Natural date range support (e.g., "today", "last 7 days")
• 10 tools for analytics queries and account info
• Rate-limited to 100 requests/minute to avoid API throttling
• Supports both historical aggregates and live visitor data
• Works across Claude Desktop, Cursor, VS Code, and CLI

Use cases of WireBoard

• Ask an LLM agent for yesterday's visitor count and top pages
• Get real-time live visitor snapshot during a support incident
• Query custom event data with grouping and filtering
• Analyze traffic breakdown by country, device, or browser
• Track daily trends for visitors, pageviews, and bounce rate

FAQ from WireBoard

What tools does WireBoard provide?

WireBoard offers 10 tools: list_sites, get_account, get_aggregate, get_timeseries, get_history, get_breakdown, get_top_urls, query_events, get_live_state, and list_dimensions — covering everything from account info to real-time snapshots to custom event queries.

How do I authenticate with WireBoard?

You need a WireBoard API token with analytics:read (for REST tools) and live:read (for live snapshot) abilities. Create one from Settings → API in your WireBoard dashboard.

What date formats are supported for queries?

All tools accept natural date ranges like "today", "yesterday", "last 7 days", "this week", "last week", "this month", "last month", or explicit ranges like "YYYY-MM-DD..YYYY-MM-DD". All times are UTC.

Is there rate limiting?

Yes. The server proactively caps itself at 100 requests per minute (under WireBoard's 120/minute API limit) so LLM bursts avoid 429 errors. You can override this with the WIREBOARD_MCP_RATE_PER_MINUTE environment variable.

What runtime or dependencies does WireBoard require?

WireBoard is installed via npm (@wireboard/mcp) or as a standalone .mcpb extension for Claude Desktop. It requires a WireBoard account and an API key. The source is MIT-licensed on GitHub.