Skip to main content
Glama
Weecare-hr

mrrscope

by Weecare-hr
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript

mrrscope

Query your MRRscope analytics from the terminal — visitors, revenue, MRR, traffic sources, AI crawlers, realtime. Built for AI agents and LLMs 🤖

The CLI is a wrapper around the public API /api/v1: every command maps to a documented REST route, and --json prints the raw response.

Quick start

npx mrrscope login       # paste an account token (create it in Settings → API)
npx mrrscope sites list
npx mrrscope analytics overview --site my-saas.com --period 30d

Or install globally:

npm install -g mrrscope

Related MCP server: @datafast/mcp-server

Commands

mrrscope login [--token mrt_xxx]     # token saved to ~/.config/mrrscope/config.json
mrrscope logout

mrrscope sites list

mrrscope analytics overview    --site my-saas.com --period 7d
mrrscope analytics timeseries  --site my-saas.com --from 2026-01-01 --to 2026-01-31
mrrscope analytics pages       --site my-saas.com --limit 25
mrrscope analytics referrers   --site my-saas.com
mrrscope analytics countries   --site my-saas.com
mrrscope analytics devices     --site my-saas.com
mrrscope analytics crawlers    --site my-saas.com   # AI bots, IP-verified
mrrscope analytics realtime    --site my-saas.com

mrrscope tokens list
mrrscope tokens create --name "SEO agent"
mrrscope tokens revoke <id>

For AI agents

# Compact JSON — pipe into jq, save to a file, feed an agent
MRRSCOPE_TOKEN=mrt_xxx mrrscope --json analytics overview --site my-saas.com | jq '.visitors'

Give your agent (Claude Code, Cursor…) an mrt_ token and it can answer "how many visitors yesterday?", "which pages earn?", "who is online right now?" by running the CLI itself.

MCP server

The package also ships an MCP (Model Context Protocol) server — your agent discovers 6 read-only analytics tools by itself:

# Claude Code
claude mcp add mrrscope --env MRRSCOPE_TOKEN=mrt_xxx -- npx -y mrrscope mcp
// Claude Desktop / Cursor
{
  "mcpServers": {
    "mrrscope": {
      "command": "npx",
      "args": ["-y", "mrrscope", "mcp"],
      "env": { "MRRSCOPE_TOKEN": "mrt_xxx" }
    }
  }
}

Tools: mrrscope_list_sites, mrrscope_overview, mrrscope_timeseries, mrrscope_breakdown, mrrscope_crawlers, mrrscope_realtime. MCP guide: https://mrrscope.com/docs/mcp

Authentication

Two token levels:

  • mrt_ account token — full account: every site, plus token management. Create it in Settings → API.

  • wf_ site key — read-only analytics, limited to the sites it covers.

Environment overrides: MRRSCOPE_TOKEN, MRRSCOPE_API_BASE.

Docs

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • @datafast/mcp-server

    Marc-Lou-Org
    A
    license
    A
    quality
    D
    maintenance
    Exposes DataFast analytics as tools for AI assistants, enabling natural language queries about website metrics such as visitors, referrers, revenue, and real-time data.
    22
    1
    MIT

  • stripe-analytics-mcp

    npow
    A
    license
    A
    quality
    F
    maintenance
    Provides real-time Stripe subscription analytics including MRR, churn, failed payments, and expiring trials. Enables AI assistants to answer business health questions like 'How's my business doing?'
    8
    MIT

  • @lodd/mcp-server

    hholen
    A
    license
    A
    quality
    D
    maintenance
    First-party web analytics MCP server for AI agents, providing 42 tools to query traffic, events, funnels, conversions, sources, and performance data.
    40
    23 npm
    MIT