Wireboard MCP server
io.github.wireboard/mcp·v0.1.3·3 starsOfficial MCP server for WireBoard. Lets LLM agents query your analytics in conversation.
3 stars40 downloads/wk
Reviews
Write oneNobody has reviewed Wireboard yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Wireboard tools (10)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
get_accountGet the team-owner identity (email, name) and the abilities of the token in use. Useful for verifying which account the MCP is connected to.
get_aggregatePeriod 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_breakdownTop-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_historyPer-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_stateCurrent 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_timeseriesOne 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_urlsPer-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_dimensionsLists 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_sitesList 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_eventsQuery 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'.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan2 source files scanned20/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 123 days ago8/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Findings (1)
- mediumeval / new Function used
exec.evaldist/index.js: …ode, sch); const makeValidate = new Function(`${names_1.default.self}`, `${names_1.de…
How Wireboard compares
Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 65/100
- higher than 25% of 4,460 AI and agents servers
- Tools
- 10
- the typical AI and agents server has 6
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 3
- more than 75% of 2,711 AI and agents servers
- Downloads a week
- 40
- more than 32% of 1,538 AI and agents servers with a package
What its tools let an agent do: 10 read
Install Wireboard in Claude Code, Cursor or VS Code
Runs npx -y @wireboard/mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add mcp -- npx -y @wireboard/mcp
What the publisher says
From the Wireboard repository's README, as published. We do not edit it. Read it on GitHub
wireboard-mcp
Official Model Context Protocol server for WireBoard.
Lets LLM agents (Claude Desktop, Cursor, VS Code, etc.) query your real-time and historical analytics in conversation. Built on top of the official @wireboard/api JavaScript SDK.
Install
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/mcpRequires Node 18+. Then configure your MCP client of choice.
Claude Desktop config
Edit claudedesktopconfig.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
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 WIREBOARDMCPRATEPERMINUTE env var if you have a use case that needs different pacing.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Wireboard: common questions
- Is Wireboard MCP server safe?
- With care: it is graded C, so read the findings first (65/100). Read the Wireboard safety report
- How do I install Wireboard?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Wireboard need an API key?
- Yes. The registry entry asks for
WIREBOARD_TOKEN. - Is Wireboard maintained?
- The last commit was 161 days ago (2026-05-27). The latest release is v0.1.3.
- What can I use instead of Wireboard?
- Servers from other publishers that do the same job: Agent-Native Analytics MCP server.
- How does Wireboard compare with other AI and agents MCP servers?
- safety score 65/100 (higher than 25% of 4,460 AI and agents servers); tools 10 (the typical AI and agents server has 6); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Wireboard
Same job from other publishers: the closest match first, then the best rated.
- Agent-Native AnalyticsAgent-Native Amplitude/Mixpanel - connect data sources, prompt for chartsnot reviewedEstablishedA