WireBoard MCP server
✓ VerifiedLets LLM agents query real-time and historical website analytics through natural language conversation.
Also known as wireboard/mcp, @wireboard/mcp
- Stars
- 3
- Tools
- 10
- Downloads, 30 days
- —
- Latest version
- 0.1.3
- Last commit
- May 27, 2026
- License
- MIT
What is WireBoard MCP?
WireBoard lets LLM agents query real-time and historical website analytics through natural language conversation. It exposes 10 tools, such as list_sites, get_account, get_aggregate.
Summary generated from the project's README
About WireBoard MCP server
Querying real-time and historical website analytics through natural language conversation is what this server enables for developers using AI clients like Claude Desktop, Cursor, or VS Code. By connecting to WireBoard, an LLM agent can retrieve specific metrics such as visitor counts, bounce rates, and pageview trends without requiring manual dashboard navigation. The server acts as a read-only bridge that fetches data using the @wireboard/api JavaScript SDK.
Users can install the server as a desktop extension via a .mcpb file for Claude Desktop or through npm for other environments. Access requires a WireBoard API token with analytics:read and live:read permissions. The system includes built-in rate limiting at 100 requests per minute to prevent hitting API limits during heavy LLM usage. It provides a wide range of specialized tools including get_live_state for real-time snapshots, get_timeseries for metric bucketing, and query_events for custom event filtering.
What you can do with it
- 1Monitor real-time site activityAsk your AI agent to report on what is happening on your website at this exact moment.
- 2Analyze historical traffic trendsRequest a comparison of visitor counts over a specific period like the last two weeks.
- 3Investigate specific page performanceIdentify which URLs within a certain directory are experiencing high bounce rates.
- 4Filter custom event dataQuery how many specific events were triggered by a particular marketing source.
Written from the project's README. Every use case is checked against a quote from it.
How to install WireBoard MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall WireBoard MCP in Claude Code
$ claude mcp add --env 'WIREBOARD_TOKEN=<YOUR_WIREBOARD_TOKEN>' mcp -- npx -y @wireboard/mcpInstall WireBoard MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@wireboard/mcp"
],
"env": {
"WIREBOARD_TOKEN": "<YOUR_WIREBOARD_TOKEN>"
}
}
}
}Install WireBoard MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@wireboard/mcp"
],
"env": {
"WIREBOARD_TOKEN": "<YOUR_WIREBOARD_TOKEN>"
}
}
}
}Install WireBoard MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@wireboard/mcp"],"env":{"WIREBOARD_TOKEN":"<YOUR_WIREBOARD_TOKEN>"}}'Install WireBoard MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@wireboard/mcp"
],
"env": {
"WIREBOARD_TOKEN": "<YOUR_WIREBOARD_TOKEN>"
}
}
}
}Install WireBoard MCP in Codex
$ codex mcp add mcp --env 'WIREBOARD_TOKEN=<YOUR_WIREBOARD_TOKEN>' -- npx -y @wireboard/mcpInstall WireBoard MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@wireboard/mcp"] [mcp_servers.mcp.env] WIREBOARD_TOKEN = "<YOUR_WIREBOARD_TOKEN>"
Install WireBoard MCP in Gemini CLI
$ gemini mcp add -s user -e 'WIREBOARD_TOKEN=<YOUR_WIREBOARD_TOKEN>' mcp npx -- -y @wireboard/mcpInstall WireBoard MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@wireboard/mcp"
],
"env": {
"WIREBOARD_TOKEN": "<YOUR_WIREBOARD_TOKEN>"
}
}
}
}WireBoard MCP tools 10
Detected from the READMElist_sitesget_accountget_aggregateget_timeseriesget_historyget_breakdownget_top_urlsquery_eventsget_live_statelist_dimensions
Configuration
WIREBOARD_TOKENRequiredSecretYour WireBoard API bearer token. Mint one at https://wireboard.io/dashboard/settings/api with the analytics:read and live:read abilities.
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablewireboard/mcp is public and reachablegithub.com/wireboard/mcp ↗Pass
- Package names this repository as its source@wireboard/mcp names wireboard/mcp as sourcenpmjs.com/package/@wireboard/mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-05-27github.com/wireboard/mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @wireboard/mcpPass
- No critical advisory in the package or its dependencies101 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model10 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubInstall
Two ways to install, pick whichever fits your setup.
Option A: Desktop Extension (recommended for Claude Desktop users)
Download wireboard-mcp-x.y.z.mcpb from the GitHub releases page and double-click it. One file works on Windows, macOS, and Linux — Claude Desktop ships its own Node runtime, so there are no system dependencies to install.
Claude Desktop will prompt for your WireBoard API token, store it securely in your OS keychain, and the WireBoard tools become available immediately.
If double-click doesn't open the file, install it via Claude Desktop → Settings → Extensions → Advanced Settings → Install Extension.
Option B: npm install (for Cursor, VS Code, headless / CI, automation)
npm install -g @wireboard/mcp
Requires Node 18+. Then configure your MCP client of choice.
Claude Desktop config
Edit claude_desktop_config.json (Settings → Developer → Edit Config):
{
"mcpServers": {
"wireboard": {
"command": "wireboard-mcp",
"env": {
"WIREBOARD_TOKEN": "your_token_here"
}
}
}
}
Restart Claude Desktop. The WireBoard tools will appear automatically.
Cursor / VS Code / other MCP clients
Use the same command + env-var pattern in your client's MCP config.
Mint a token
You need a WireBoard API token before either install path will work. Mint one at Settings → API with the analytics:read ability for REST tools and live:read for the live snapshot tool.
What you can ask
Once configured, ask Claude things like:
- "How many visitors did my site get last week?"
- "Show me the top 10 referrers for the past 30 days."
- "What's happening on my site right now?"
- "Which pages under /checkout have the worst bounce rate this month?"
- "How many Purchase events fired from utm_source=newsletter yesterday?"
- "Compare visitor counts day by day for the past two weeks."
Claude will pick the right tool, call it, and answer in natural language.
Available 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 (visitors or pageviews) bucketed by hour or day |
get_history |
Per-day visitors / returning / pageviews / bounce / duration |
get_breakdown |
Top-N rows by dimension (country, device, browser, referrer, etc.) |
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, etc.) |
list_dimensions |
Meta: every dimension, metric, and limit the API supports |
All tools accept natural date ranges: "today", "yesterday", "last 7 days" (or "30d" shorthand), "this week", "last week", "this month", "last month", or explicit "YYYY-MM-DD..YYYY-MM-DD". Always UTC.
Rate limiting
The MCP 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 the WIREBOARD_MCP_RATE_PER_MINUTE env var if you have a use case that needs different pacing.
The underlying SDK still auto-retries on 429 as a backstop.
Security
- Treat your token like a credential. It has full
analytics:readandlive:readscope on every site in the account. - Don't commit your MCP client config to a public repo with the token in it. Use an env var or a secret manager and reference it from your config.
- Revoke and rotate if a token leaks. Settings → API in your dashboard.
The MCP is read-only: it can fetch data, never modify it. The WireBoard public API itself is read-only in v1.
Logging
Logs go to stderr (so they don't interfere with the MCP protocol on stdout).
Source and contributing
- npm:
@wireboard/mcp - Repository:
github.com/wireboard/mcp - Releases (.mcpb downloads):
github.com/wireboard/mcp/releases - Issues:
github.com/wireboard/mcp/issues - Underlying SDK:
@wireboard/api(source) - WireBoard docs: https://wireboard.io/docs/api-overview
Building locally
npm install
npm test # run vitest
npm run build # bundle TS → dist/index.js (esbuild, ~600 KB)
npm run build:mcpb # also pack dist/wireboard-mcp-<version>.mcpb
The .mcpb is a zip of manifest.json, icon.png, and the single bundled dist/index.js. All runtime dependencies are inlined by esbuild.
License
MIT.
WireBoard MCP questions
How do I add WireBoard MCP to Claude Code?
Run claude mcp add --env 'WIREBOARD_TOKEN=<YOUR_WIREBOARD_TOKEN>' mcp -- npx -y @wireboard/mcp in your terminal. Add --scope user to make it available in every project.
How do I add WireBoard MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does WireBoard MCP provide?
It exposes 10 tools, including list_sites, get_account, get_aggregate, get_timeseries, get_history.
How do I install the WireBoard MCP server?
You can install it as a desktop extension by downloading the .mcpb file from GitHub releases, or via npm using 'npm install -g @wireboard/mcp'.
Is the WireBoard MCP server read-only?
Yes, the MCP can only fetch data and cannot modify your analytics.
Does the server have rate limiting?
Yes, it proactively caps itself at 100 requests per minute to prevent hitting API limits.