Back to Browse
Free
Server data from the Official MCP Registry
Multi-site analytics as tools: GA4, Search Console, Cloudflare edge, PageSpeed, insights.
About
Multi-site analytics as tools: GA4, Search Console, Cloudflare edge, PageSpeed, insights.
Security Report
4.8
Use Caution4.8High RiskFleets is a well-structured analytics CLI and MCP server with proper authentication handling and appropriate permission scoping. The codebase uses environment variables and secure credential storage for tokens, implements input validation via Zod, and all network calls are authenticated with Bearer tokens. Minor code quality findings (broad error handling, limited input sanitization in URL construction) do not significantly impact security given the read-only nature of most operations and the server's legitimate need for network access to analytics APIs. Supply chain analysis found 2 known vulnerabilities in dependencies (2 critical, 0 high severity). Package verification found 1 issue (1 critical, 0 high severity).
7 files analyzed · 8 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
Unverified package source
We couldn't verify that the installable package matches the reviewed source code. Proceed with caution.
What You'll Need
Set these up before or after installing:
Fleets personal access token (fl_...). Optional if you have already run `fleets login`; otherwise mint one at https://fleets.run/app/account?tab=cli.Required
Environment variable: FLEETS_TOKEN
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-runfleets-cli": {
"env": {
"FLEETS_TOKEN": "your-fleets-token-here"
},
"args": [
"-y",
"fleets"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
fleets
Terminal CLI for Fleets. Per-site commands mirror the app UI tabs at https://fleets.run/app/<slug>/<tab>.
Install
npm install -g fleets
Authenticate
fleets login
Picks between two methods:
- browser (default) — device flow: CLI prints a URL + 8-character code, auto-opens your browser, you click authorize, CLI finishes automatically.
- paste a token — mint one in app → account → cli, paste it in.
Skip the prompt with a flag:
fleets login --browser # force device flow
fleets login --paste # force token paste
fleets login --token fl_xxxxxxxxxxxxxxxx # paste in one shot (CI)
export FLEETS_TOKEN=fl_xxxxxxxxxxxxxxxx # skip login entirely
Slug-first dispatch
The most intuitive way to run commands is to put the site slug first, like you're "inside" that site:
fleets fightbets # GA4 summary (defaults to stats)
fleets fightbets sources # top traffic sources
fleets fightbets funnel session_start view # conversion funnel
fleets fightbets seo --range 30d # GSC summary, last 30 days
fleets fightbets open settings # print app URL
The legacy form fleets <command> <slug> (e.g. fleets sources fightbets) still works.
Commands
Setup
| Command | Description |
|---|---|
fleets login | Browser device-flow auth (no paste) |
fleets add <domain> [--detect] | Create a site; --detect auto-links GA4 + GSC |
fleets connect <slug> | Auto-detect GA4 + GSC via service account |
fleets connect <slug> --property <id> | Set GA4 property explicitly |
fleets connect <slug> --gsc <site-url> | Set GSC site explicitly |
Analytics (per-site)
All accept --range (default 7d) and --json. Commands with top-N tables also accept --limit.
| Command | Tab | Data source |
|---|---|---|
fleets list | — | All your sites with sparkline + Δ7d |
fleets <slug> / fleets stats <slug> | day | GA4 summary |
fleets <slug> sources | sources | GA4 traffic sources |
fleets <slug> campaigns | campaigns | GA4 UTM campaigns |
fleets <slug> referrals | referrals | GA4 referrals |
fleets <slug> landers | landers | GA4 landing pages |
fleets <slug> events | events | GA4 events |
fleets <slug> users | users | GA4 country + device breakdown |
fleets <slug> funnel <step1> <step2>… | funnel | GA4 funnel |
fleets <slug> seo | seo | Google Search Console |
fleets <slug> edge | edge | Cloudflare Analytics |
fleets <slug> speed | speed | PageSpeed Insights |
Utility
| Command | Description |
|---|---|
fleets <slug> export | Daily GA4 CSV/JSON export |
fleets <slug> query "<text>" | Natural-language analytics query |
fleets <slug> open [tab] | Print the app URL for a site |
MCP server
The same package ships an MCP server, fleets-mcp,
so agents (Claude Code, Claude Desktop, Cursor, …) can pull your live Fleets
analytics as tools. It reuses the CLI's auth — run fleets login once (or set
FLEETS_TOKEN) and the MCP server picks up the same token from ~/.fleets/config.json.
Add it to a client
Claude Code:
claude mcp add fleets -- fleets-mcp
Claude Desktop / Cursor (claude_desktop_config.json or .cursor/mcp.json):
{
"mcpServers": {
"fleets": {
"command": "fleets-mcp"
}
}
}
No global install? Use npx with the fleets-mcp launcher package:
{
"mcpServers": {
"fleets": {
"command": "npx",
"args": ["-y", "fleets-mcp"]
}
}
}
If you authenticate via env instead of fleets login, add
"env": { "FLEETS_TOKEN": "fl_xxx" } to the server entry.
Tools
All read-only except log_change (writes a change-log entry). Every analytics
tool takes a slug (from list_sites) and an optional range (7d, 30d, 24h).
| Tool | What it returns |
|---|---|
list_sites | All sites + connected sources (GA4 / Cloudflare / GSC) — start here |
stats | GA4 summary: sessions, users, pageviews, events, engagement, bounce |
sources · campaigns · referrals · landers · events | GA4 breakdowns (accept limit) |
users · devices · demographics | GA4 audience breakdowns |
funnel | GA4 conversion funnel across steps (2+) |
seo | Google Search Console summary |
edge | Cloudflare edge analytics (bots, humans, cache) |
speed | PageSpeed Insights + Core Web Vitals |
insights | AI-ready signals worth investigating (optionally per site) |
ask | Natural-language question answered server-side with citations |
log_change · recall | Write / read the per-site change log |
Environment variables
| Variable | Description |
|---|---|
FLEETS_TOKEN | Personal access token. Skip fleets login entirely — useful for CI. Overrides ~/.fleets/config.json. |
Range format
All --range flags accept:
7d— last 7 days30d— last 30 days90d— last 90 days24h— last 24 hours (rounds to 1 day)
Requirements
- Node.js >= 22 (LTS)
- Works on macOS, Linux, Windows
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
80.0K
Stars
6
Installs
6.5
Security
No ratings yet
Local
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
137
Stars
533
Installs
8.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
80
Installs
10.0
Security
4.6
Local