Skip to main content
Glama
nks-hub

rybbit-mcp

by nks-hub
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

@nks-hub/rybbit-mcp

Build Status npm version License: MIT TypeScript MCP SDK

MCP server for Rybbit Analytics — query statistics, errors, users, sessions, funnels, goals, and performance metrics directly from Claude Code or any MCP-compatible client.

Why?

Instead of manually checking the Rybbit dashboard, let your AI assistant query analytics data directly:

  • "How many users visited the site today?"

  • "Show me the top pages by bounce rate this week"

  • "What errors occurred in the last hour?"

  • "Show user journey from homepage to checkout"

  • "Compare browser usage between mobile and desktop"

Related MCP server: agentops-mcp

Quick Start

Installation (npx — recommended)

No install needed. Just configure your MCP client to run via npx:

{
  "mcpServers": {
    "rybbit": {
      "command": "npx",
      "args": ["-y", "@nks-hub/rybbit-mcp"],
      "env": {
        "RYBBIT_URL": "https://your-rybbit-instance.com",
        "RYBBIT_API_KEY": "your-api-key"
      }
    }
  }
}

Add this to your ~/.claude/settings.json or project .claude/settings.json.

CLI shorthand:

claude mcp add rybbit -e RYBBIT_URL=https://your-instance.com -e RYBBIT_API_KEY=your-key -- npx -y @nks-hub/rybbit-mcp

Installation (from source)

For development or contributing:

git clone https://github.com/nks-hub/rybbit-mcp.git
cd rybbit-mcp
npm install && npm run build

Then point your MCP config to the local build:

{
  "mcpServers": {
    "rybbit": {
      "command": "node",
      "args": ["path/to/rybbit-mcp/build/index.js"],
      "env": {
        "RYBBIT_URL": "https://your-rybbit-instance.com",
        "RYBBIT_API_KEY": "your-api-key"
      }
    }
  }
}

Usage

Ask Claude Code anything about your analytics data. The MCP tools are automatically available.

Features

Feature

Description

32 Analytics Tools

Complete coverage of Rybbit API — overview, metrics, sessions, users, events, errors, performance, funnels, goals, journeys, site management

Flexible Auth

API key (recommended) or email/password authentication

Smart Filtering

Filter by 22 dimensions (browser, country, UTM, page, device, etc.) with 8 comparison types

Time Ranges

Date ranges (YYYY-MM-DD) or relative time (pastMinutesStart)

Time Series

Configurable bucket granularity from minutes to years

Pagination

Built-in page/limit support for large datasets

Response Truncation

Auto-truncation at 25k chars to prevent context bloat

Actionable Errors

Error messages guide the LLM toward correct tool usage

Authentication

Supports two authentication methods:

Method

Environment Variables

Use Case

API Key

RYBBIT_API_KEY

Recommended for production

Email/Password

RYBBIT_EMAIL, RYBBIT_PASSWORD

Development/testing

Both require RYBBIT_URL pointing to your Rybbit instance.

Tools (32)

Configuration & Site Management

Tool

Description

rybbit_get_config

Get server version and configuration

rybbit_list_sites

List all sites and organizations

rybbit_create_site

Create a new site (type: web or mobile; legacy alias app maps to mobile — mobile sites auto-disable bot filtering)

rybbit_delete_site

Delete a site permanently

rybbit_get_site_id

Look up site ID by domain name

rybbit_update_site_config

Update site tracking config (IP, errors, replay, etc.)

Real-time & Overview

Tool

Description

rybbit_live_users

Current active users count

rybbit_get_overview

Aggregated metrics (sessions, pageviews, users, bounce rate, duration)

rybbit_get_overview_timeseries

Metrics as time-series with configurable buckets

rybbit_get_session_locations

Geographic session data with coordinates for map visualization

Metrics & Dimensions

Tool

Description

rybbit_get_metric

Breakdown by dimension (browser, OS, country, page, UTM, etc.)

rybbit_get_retention

User retention cohort analysis

Sessions

Tool

Description

rybbit_list_sessions

Session list with filtering by IP, identified users, min duration, and pagination

rybbit_get_session

Full session detail with events and user traits

Users

Tool

Description

rybbit_list_users

Users with search, sort (first/last seen, pageviews, sessions, duration), and identified-only filter

rybbit_get_user

User detail with traits and activity

rybbit_get_user_traits

Trait keys, values, or find users by trait

rybbit_get_user_event_breakdown

Per-user event count breakdown

Events

Tool

Description

rybbit_list_events

Raw event records with filtering

rybbit_get_event_names

Custom event names and counts

rybbit_get_event_properties

Property breakdowns per event

rybbit_get_event_timeseries

Event count trends over time with configurable buckets

rybbit_get_outbound_links

Outbound link clicks with URLs and counts

Errors

Tool

Description

rybbit_get_errors

Error types/counts, individual instances, or timeseries for a specific error

Performance (Web Vitals)

Tool

Description

rybbit_get_performance

Core Web Vitals (LCP, CLS, INP, FCP, TTFB) with percentiles

rybbit_get_performance_timeseries

Web Vitals trends over time

Funnels & Goals

Tool

Description

rybbit_list_funnels

Saved funnels with step definitions

rybbit_analyze_funnel

Ad-hoc funnel analysis with custom steps

rybbit_get_funnel_step_sessions

Sessions that reached or dropped off at a funnel step

rybbit_list_goals

Goals with conversion metrics

rybbit_get_goal_sessions

Sessions that completed a specific goal

Journeys

Tool

Description

rybbit_get_journeys

User navigation path analysis

Common Parameters

All analytics tools support these optional parameters:

Parameter

Type

Description

siteId

string

Site identifier (required)

startDate

string

Start date YYYY-MM-DD

endDate

string

End date YYYY-MM-DD

timeZone

string

IANA timezone (e.g., Europe/Prague)

filters

array

Filter array [{parameter, type, value[]}]

pastMinutesStart

number

Minutes ago (alternative to date range)

Filter Parameters

browser, operating_system, language, country, region, city, device_type, referrer, hostname, pathname, page_title, querystring, event_name, channel, utm_source, utm_medium, utm_campaign, utm_term, utm_content, entry_page, exit_page, user_id

Filter Types

equals, not_equals, contains, not_contains, regex, not_regex, greater_than, less_than

Time Buckets

minute, five_minutes, ten_minutes, fifteen_minutes, hour, day, week, month, year

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

# Type checking
npx tsc --noEmit

Requirements

  • Node.js: 18+

  • Rybbit Analytics: Self-hosted or cloud instance

Contributing

Contributions are welcome! For major changes, please open an issue first.

  1. Fork the repository

  2. Create your feature branch (git checkout -b feature/amazing-feature)

  3. Commit your changes (git commit -m 'feat: description')

  4. Push to the branch (git push origin feature/amazing-feature)

  5. Open a Pull Request

Support

License

MIT License — see LICENSE for details.

Links

Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
1dRelease cycle
10Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/nks-hub/rybbit-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server