WireBoard

by wireboard

350 downloads

Not rated

GitHub

About

Official MCP server for WireBoard analytics. Query real-time and historical visitor data, custom events, and per-site reports in conversation with Claude, Cursor, VS Code, and other MCP clients.

Details

Author: wireboard
Downloads: 350
Categories: Marketing, Other, AI

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name WireBoard

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "wireboard": {
            "wireboard": {
                "command": "npx",
                "args": [
                    "-y",
                    "@wireboard/mcp"
                ],
                "env": {
                    "WIREBOARD_TOKEN": "<YOUR_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "wireboard": {
            "wireboard": {
                "command": "npx",
                "args": [
                    "-y",
                    "@wireboard/mcp"
                ],
                "env": {
                    "WIREBOARD_TOKEN": "<YOUR_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "wireboard": {
            "wireboard": {
                "command": "npx",
                "args": [
                    "-y",
                    "@wireboard/mcp"
                ],
                "env": {
                    "WIREBOARD_TOKEN": "<YOUR_TOKEN>"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "wireboard": {
            "wireboard": {
                "command": "npx",
                "args": [
                    "-y",
                    "@wireboard/mcp"
                ],
                "env": {
                    "WIREBOARD_TOKEN": "<YOUR_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "wireboard": {
            "wireboard": {
                "command": "npx",
                "args": [
                    "-y",
                    "@wireboard/mcp"
                ],
                "env": {
                    "WIREBOARD_TOKEN": "<YOUR_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "wireboard": {
            "wireboard": {
                "command": "npx",
                "args": [
                    "-y",
                    "@wireboard/mcp"
                ],
                "env": {
                    "WIREBOARD_TOKEN": "<YOUR_TOKEN>"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "wireboard": {
            "wireboard": {
                "command": "npx",
                "args": [
                    "-y",
                    "@wireboard/mcp"
                ],
                "env": {
                    "WIREBOARD_TOKEN": "<YOUR_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "wireboard": {
            "wireboard": {
                "command": "npx",
                "args": [
                    "-y",
                    "@wireboard/mcp"
                ],
                "env": {
                    "WIREBOARD_TOKEN": "<YOUR_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "wireboard": {
            "wireboard": {
                "command": "npx",
                "args": [
                    "-y",
                    "@wireboard/mcp"
                ],
                "env": {
                    "WIREBOARD_TOKEN": "<YOUR_TOKEN>"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "wireboard": {
            "wireboard": {
                "command": "npx",
                "args": [
                    "-y",
                    "@wireboard/mcp"
                ],
                "env": {
                    "WIREBOARD_TOKEN": "<YOUR_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "wireboard": {
            "wireboard": {
                "command": "npx",
                "args": [
                    "-y",
                    "@wireboard/mcp"
                ],
                "env": {
                    "WIREBOARD_TOKEN": "<YOUR_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "wireboard": {
            "wireboard": {
                "command": "npx",
                "args": [
                    "-y",
                    "@wireboard/mcp"
                ],
                "env": {
                    "WIREBOARD_TOKEN": "<YOUR_TOKEN>"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "wireboard": {
            "wireboard": {
                "command": "npx",
                "args": [
                    "-y",
                    "@wireboard/mcp"
                ],
                "env": {
                    "WIREBOARD_TOKEN": "<YOUR_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "wireboard": {
            "wireboard": {
                "command": "npx",
                "args": [
                    "-y",
                    "@wireboard/mcp"
                ],
                "env": {
                    "WIREBOARD_TOKEN": "<YOUR_TOKEN>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "wireboard": {
            "wireboard": {
                "command": "npx",
                "args": [
                    "-y",
                    "@wireboard/mcp"
                ],
                "env": {
                    "WIREBOARD_TOKEN": "<YOUR_TOKEN>"
                }
            }
        }
    }
}

From the repository

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.

`list_sites`

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.

`get_account`

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.

`get_aggregate`

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.

`get_timeseries`

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.

`get_history`

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.

`get_breakdown`

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.

`get_top_urls`

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.

`query_events`

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

`get_live_state`

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

`list_dimensions`

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "wireboard": {
            "wireboard": {
                "command": "npx",
                "args": [
                    "-y",
                    "@wireboard/mcp"
                ],
                "env": {
                    "WIREBOARD_TOKEN": "<YOUR_TOKEN>"
                }
            }
        }
    }
}

McpServers

{
    "wireboard": {
        "command": "npx",
        "args": [
            "-y",
            "@wireboard/mcp"
        ],
        "env": {
            "WIREBOARD_TOKEN": "<YOUR_TOKEN>"
        }
    }
}

Official Model Context Protocol server forWireBoard.

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/apiJavaScript SDK.

Two ways to install, pick whichever fits your setup.

Option A: Desktop Extension (recommended for Claude Desktop users)

Downloadwireboard-mcp-x.y.z.mcpbfrom the GitHub releases pageand 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)

Requires Node 18+. Then configure your MCP client of choice.

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

Use the same command + env-var pattern in your client's MCP config.

You need a WireBoard API token before either install path will work. Mint one at Settings → APIwith theanalytics:readability for REST tools andlive:readfor the live snapshot tool.

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.

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.

The MCP proactively caps itself at100 requests/minute(under the API's 120/minute limit) so LLM bursts space themselves out instead of hitting 429s. Override with theWIREBOARD_MCP_RATE_PER_MINUTEenv var if you have a use case that needs different pacing.

The underlying SDK still auto-retries on 429 as a backstop.

- Treat your token like a credential.It has fullanalytics: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 rotateif 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.

Logs go to stderr (so they don't interfere with the MCP protocol on stdout).

- 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

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.mcpbis a zip ofmanifest.json,icon.png, and the single bundleddist/index.js. All runtime dependencies are inlined by esbuild.

Free MCP that drives an audit of your marketing. Your AI connects, adsOS digs through your ads, email and site, and hands back a growth plan you can run today.

AI marketing analyst that connects Google Ads, Meta Ads, GA4, Search Console, and Stripe to audit campaigns, analyze funnels, and catch wasted ad spend from one chat.

App Store stats, installs, keywords, revenue and descriptions. B2B intelligence for SDK analysis, ad tech stacks and more.

BestAppify — Shopify App Store Intelligence

Live Shopify App Store data in your AI client — keyword rankings, competitor tracking, review intelligence and revenue analytics across 40 tools, with a free tier.

CalmSEO gives AI assistants live SEO data for keyword research, SERP checks, competitor keywords, page audits, and Google Search Console insights through MCP.

Run creator storefronts, listings, orders, content, fulfillment, and analytics through AI.

GEO analysis tools for various MCP clients

Request AI-Readiness and Marketing Signal scans from MCP-compatible coding agents, then read prioritized findings through the index365 API.

Official Nightwatch SEO MCP server — query live rank tracking, AI visibility, keyword research, site audits, and reports from Claude, Cursor, ChatGPT.

SEO + GEO MCP: live Google Search Console data, keyword and page analysis, site audit and SEO tasks — 21 tools.

Post-publish SEO performance MCP that scores every URL across Google Search Console, GA4, Matomo, Clarity, and AI citations and emits a refresh/expand/merge/kill verdict per post.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

list_sites

get_account

get_aggregate

get_timeseries

get_history

get_breakdown

get_top_urls

query_events

get_live_state

list_dimensions

Claude Desktop / Cursor

McpServers

Option A: Desktop Extension (recommended for Claude Desktop users)

Option B: npm install (for Cursor, VS Code, headless / CI, automation)

BestAppify — Shopify App Store Intelligence

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Context 7

Reactive Resume

`list_sites`

`get_account`

`get_aggregate`

`get_timeseries`

`get_history`

`get_breakdown`

`get_top_urls`

`query_events`

`get_live_state`

`list_dimensions`