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" Or clone and build: Add to your ~/.claude/settings.json or
Add this skill
npx mdskills install nks-hub/rybbit-mcpComprehensive MCP server with 31 tools for Rybbit Analytics queries, well-documented with clear setup
MCP server for Rybbit Analytics — query statistics, errors, users, sessions, funnels, goals, and performance metrics directly from Claude Code or any MCP-compatible client.
Instead of manually checking the Rybbit dashboard, let your AI assistant query analytics data directly:
npm install -g @nks-hub/rybbit-mcp
Or clone and build:
git clone https://github.com/nks-hub/rybbit-mcp.git
cd rybbit-mcp
npm install && npm run build
Add to your ~/.claude/settings.json or project .claude/settings.json:
{
"mcpServers": {
"rybbit": {
"command": "npx",
"args": ["-y", "@nks-hub/rybbit-mcp"],
"env": {
"RYBBIT_URL": "https://your-rybbit-instance.com",
"RYBBIT_API_KEY": "your-api-key"
}
}
}
}
Ask Claude Code anything about your analytics data. The MCP tools are automatically available.
| Feature | Description |
|---|---|
| 31 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 |
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.
| 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 in an organization |
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.) |
| 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 |
| Tool | Description |
|---|---|
rybbit_get_metric | Breakdown by dimension (browser, OS, country, page, UTM, etc.) |
rybbit_get_retention | User retention cohort analysis |
| Tool | Description |
|---|---|
rybbit_list_sessions | Session list with filtering and pagination |
rybbit_get_session | Full session detail with events and user traits |
| Tool | Description |
|---|---|
rybbit_list_users | Identified users with session counts and traits |
rybbit_get_user | User detail with traits and activity |
rybbit_get_user_traits | Trait keys, values, or find users by trait |
| 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 |
| Tool | Description |
|---|---|
rybbit_get_errors | Error types/counts, individual instances, or timeseries for a specific error |
| Tool | Description |
|---|---|
rybbit_get_performance | Core Web Vitals (LCP, CLS, INP, FCP, TTFB) with percentiles |
rybbit_get_performance_timeseries | Web Vitals trends over time |
| 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 |
| Tool | Description |
|---|---|
rybbit_get_journeys | User navigation path analysis |
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) |
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
equals, not_equals, contains, not_contains, regex, not_regex, greater_than, less_than
minute, five_minutes, ten_minutes, fifteen_minutes, hour, day, week, month, year
# Install dependencies
npm install
# Build
npm run build
# Watch mode
npm run dev
# Type checking
npx tsc --noEmit
Contributions are welcome! For major changes, please open an issue first.
git checkout -b feature/amazing-feature)git commit -m 'feat: description')git push origin feature/amazing-feature)MIT License — see LICENSE for details.
Made with ❤️ by NKS Hub
Install via CLI
npx mdskills install nks-hub/rybbit-mcpNks Hub/rybbit MCP is a free, open-source AI agent skill. 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" Or clone and build: Add to your ~/.claude/settings.json or
Install Nks Hub/rybbit MCP with a single command:
npx mdskills install nks-hub/rybbit-mcpThis downloads the skill files into your project and your AI agent picks them up automatically.
Nks Hub/rybbit MCP works with Claude Code, Claude Desktop, Cursor, Vscode Copilot, Windsurf, Continue Dev, Gemini Cli, Amp, Roo Code, Goose. Skills use the open SKILL.md format which is compatible with any AI coding agent that reads markdown instructions.