io.github.wireboard/mcp

NPM · @WIREBOARD/MCP · SCANNED AUG 3

Official MCP server for WireBoard. Lets LLM agents query your analytics in conversation.

Available components

+24 this week 68 68 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 67 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability70

AI-judged instruction clarity (excellent).Pass
Context-footprint check failed: tool/resource definitions use about 1606 tokens (~160/item across 10 items; 10 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management23

Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @wireboard/mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add wireboard-mcp -- npx -y @wireboard/mcp

# add to Codex CLI

codex mcp add wireboard-mcp -- npx -y @wireboard/mcp

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "wireboard-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@wireboard/mcp"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add wireboard-mcp --command npx --arg -y --arg @wireboard/mcp

# ~/.hermes/config.yaml

mcp_servers:
  wireboard-mcp:
    command: "npx"
    args: ["-y", "@wireboard/mcp"]

// mcp.json

{
  "mcpServers": {
    "wireboard-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@wireboard/mcp"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 +47
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Schema quality: unverified → excellent ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- License: unverified → pass ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Stability: unverified → 0.23 ▲ functional
- Licence: MIT functional
2 Aug 26 +2
- Malware scan: unverified → pass ▲ security
- Tool coverage: 100 → unverified ▼ functional
- Dependency health: unverified → partial ▲ functional
- First check of Schema quality: unverified functional
31 Jul 26 −7
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 −18
- Malware scan: pass → unverified ▼ security
27 Jul 26 44

First indexed and scored.

Show 2 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/@wireboard/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 96 packages

96 packages in the resolved dependency tree · 95 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 10 exposed · ~1,606 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

get_account ~38

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.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_aggregate ~143

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.

Input Output Examples

Name	Type	Req	Description
range	string	yes	Date range. Accepts natural strings ('today', 'yesterday', 'last 7 days', 'last 30 days', 'this week', 'last week', 'this month', 'last month') or an explicit 'YYYY-MM-DD..YYYY-MM-DD' range. UTC. If…
site_id	string	yes	Site ID. Get it from list_sites if you don't know it.

No output schema declared.

No examples provided.

get_breakdown ~215

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.

Input Output Examples

Name	Type	Req	Description
dimension	string	yes	Which dimension to break down by. ref_url/ref_medium/ref_source/ref_search/ref_social are a partition of referrers (a referrer lands in exactly one).
limit	integer	—	Max rows to return. Default 50, max 500.
range	string	yes	Date range. Accepts natural strings ('today', 'yesterday', 'last 7 days', 'last 30 days', 'this week', 'last week', 'this month', 'last month') or an explicit 'YYYY-MM-DD..YYYY-MM-DD' range. UTC. If…
site_id	string	yes	Site ID. Get it from list_sites if you don't know it.

No output schema declared.

No examples provided.

get_history ~157

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.

Input Output Examples

Name	Type	Req	Description
range	string	yes	Date range. Accepts natural strings ('today', 'yesterday', 'last 7 days', 'last 30 days', 'this week', 'last week', 'this month', 'last month') or an explicit 'YYYY-MM-DD..YYYY-MM-DD' range. UTC. If…
site_id	string	yes	Site ID. Get it from list_sites if you don't know it.

No output schema declared.

No examples provided.

get_live_state ~114

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'.

Input Output Examples

Name	Type	Req	Description
categories	array	—	Subset of the 20 live categories to include. Omit to get all categories. Smaller subsets are faster.
site_id	string	yes	Site ID. Get it from list_sites if you don't know it.

No output schema declared.

No examples provided.

get_timeseries ~182

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.

Input Output Examples

Name	Type	Req	Description
interval	string	yes	Bucket size. Use 'hour' for short ranges, 'day' for longer.
metric	string	yes	Which metric to plot.
range	string	yes	Date range. Accepts natural strings ('today', 'yesterday', 'last 7 days', 'last 30 days', 'this week', 'last week', 'this month', 'last month') or an explicit 'YYYY-MM-DD..YYYY-MM-DD' range. UTC. If…
site_id	string	yes	Site ID. Get it from list_sites if you don't know it.

No output schema declared.

No examples provided.

get_top_urls ~343

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.

Input Output Examples

Name	Type	Req	Description
contains	string	—	Match URLs that contain this substring anywhere. Use this when the user gives you a path or a keyword without specifying the full URL (e.g. user says 'checkout pages' → contains='/checkout').
exact	string	—	Match the URL that equals this string exactly. Like `prefix`, this is a full URL: scheme + host + path.
limit	integer	—	Max rows. Default 50, max 500.
offset	integer	—	Pagination offset. Default 0.
prefix	string	—	Match URLs whose value starts with this string. URLs are stored as full URLs (scheme + host + path), so pass a full prefix like 'https://yoursite.com/blog/', NOT just '/blog/'. If you only have a pat…
range	string	yes	Date range. Accepts natural strings ('today', 'yesterday', 'last 7 days', 'last 30 days', 'this week', 'last week', 'this month', 'last month') or an explicit 'YYYY-MM-DD..YYYY-MM-DD' range. UTC. If…
site_id	string	yes	Site ID. Get it from list_sites if you don't know it.

No output schema declared.

No examples provided.

list_dimensions ~57

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.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_sites ~54

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.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

query_events ~303

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'.

Input Output Examples

Name	Type	Req	Description
filter	object	—	Filters as {field: value}. Allowed top-level fields: category, action, label, utm_*. Event props go under {'props': {'key': 'value'}} which translates to filter[props.key]=value on the wire.
group_by	array	—	Fields to group by. Allowed: category, action, label, utm_campaign, utm_source, utm_medium, utm_content, utm_term. Default: ['category', 'action', 'label'].
limit	integer	—	Max rows. Default 50, max 1000.
offset	integer	—	Pagination offset. Default 0.
range	string	yes	Date range. Accepts natural strings ('today', 'yesterday', 'last 7 days', 'last 30 days', 'this week', 'last week', 'this month', 'last month') or an explicit 'YYYY-MM-DD..YYYY-MM-DD' range. UTC. If…
site_id	string	yes	Site ID. Get it from list_sites if you don't know it.

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug