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
1# @nks-hub/rybbit-mcp23[](https://github.com/nks-hub/rybbit-mcp/actions)4[](https://www.npmjs.com/package/@nks-hub/rybbit-mcp)5[](LICENSE)6[](https://www.typescriptlang.org/)7[](https://modelcontextprotocol.io/)89> MCP server for [Rybbit Analytics](https://github.com/rybbit-io/rybbit) — query statistics, errors, users, sessions, funnels, goals, and performance metrics directly from Claude Code or any MCP-compatible client.1011---1213## Why?1415Instead of manually checking the Rybbit dashboard, let your AI assistant query analytics data directly:1617- "How many users visited the site today?"18- "Show me the top pages by bounce rate this week"19- "What errors occurred in the last hour?"20- "Show user journey from homepage to checkout"21- "Compare browser usage between mobile and desktop"2223---2425## Quick Start2627### Installation2829```bash30npm install -g @nks-hub/rybbit-mcp31```3233Or clone and build:3435```bash36git clone https://github.com/nks-hub/rybbit-mcp.git37cd rybbit-mcp38npm install && npm run build39```4041### Configuration4243Add to your `~/.claude/settings.json` or project `.claude/settings.json`:4445```json46{47 "mcpServers": {48 "rybbit": {49 "command": "npx",50 "args": ["-y", "@nks-hub/rybbit-mcp"],51 "env": {52 "RYBBIT_URL": "https://your-rybbit-instance.com",53 "RYBBIT_API_KEY": "your-api-key"54 }55 }56 }57}58```5960### Usage6162Ask Claude Code anything about your analytics data. The MCP tools are automatically available.6364---6566## Features6768| Feature | Description |69|---------|-------------|70| **31 Analytics Tools** | Complete coverage of Rybbit API — overview, metrics, sessions, users, events, errors, performance, funnels, goals, journeys, site management |71| **Flexible Auth** | API key (recommended) or email/password authentication |72| **Smart Filtering** | Filter by 22 dimensions (browser, country, UTM, page, device, etc.) with 8 comparison types |73| **Time Ranges** | Date ranges (`YYYY-MM-DD`) or relative time (`pastMinutesStart`) |74| **Time Series** | Configurable bucket granularity from minutes to years |75| **Pagination** | Built-in page/limit support for large datasets |76| **Response Truncation** | Auto-truncation at 25k chars to prevent context bloat |77| **Actionable Errors** | Error messages guide the LLM toward correct tool usage |7879---8081## Authentication8283Supports two authentication methods:8485| Method | Environment Variables | Use Case |86|--------|----------------------|----------|87| **API Key** | `RYBBIT_API_KEY` | Recommended for production |88| **Email/Password** | `RYBBIT_EMAIL`, `RYBBIT_PASSWORD` | Development/testing |8990Both require `RYBBIT_URL` pointing to your Rybbit instance.9192---9394## Tools (31)9596### Configuration & Site Management97| Tool | Description |98|------|-------------|99| `rybbit_get_config` | Get server version and configuration |100| `rybbit_list_sites` | List all sites and organizations |101| `rybbit_create_site` | Create a new site in an organization |102| `rybbit_delete_site` | Delete a site permanently |103| `rybbit_get_site_id` | Look up site ID by domain name |104| `rybbit_update_site_config` | Update site tracking config (IP, errors, replay, etc.) |105106### Real-time & Overview107| Tool | Description |108|------|-------------|109| `rybbit_live_users` | Current active users count |110| `rybbit_get_overview` | Aggregated metrics (sessions, pageviews, users, bounce rate, duration) |111| `rybbit_get_overview_timeseries` | Metrics as time-series with configurable buckets |112| `rybbit_get_session_locations` | Geographic session data with coordinates for map visualization |113114### Metrics & Dimensions115| Tool | Description |116|------|-------------|117| `rybbit_get_metric` | Breakdown by dimension (browser, OS, country, page, UTM, etc.) |118| `rybbit_get_retention` | User retention cohort analysis |119120### Sessions121| Tool | Description |122|------|-------------|123| `rybbit_list_sessions` | Session list with filtering and pagination |124| `rybbit_get_session` | Full session detail with events and user traits |125126### Users127| Tool | Description |128|------|-------------|129| `rybbit_list_users` | Identified users with session counts and traits |130| `rybbit_get_user` | User detail with traits and activity |131| `rybbit_get_user_traits` | Trait keys, values, or find users by trait |132133### Events134| Tool | Description |135|------|-------------|136| `rybbit_list_events` | Raw event records with filtering |137| `rybbit_get_event_names` | Custom event names and counts |138| `rybbit_get_event_properties` | Property breakdowns per event |139| `rybbit_get_event_timeseries` | Event count trends over time with configurable buckets |140| `rybbit_get_outbound_links` | Outbound link clicks with URLs and counts |141142### Errors143| Tool | Description |144|------|-------------|145| `rybbit_get_errors` | Error types/counts, individual instances, or timeseries for a specific error |146147### Performance (Web Vitals)148| Tool | Description |149|------|-------------|150| `rybbit_get_performance` | Core Web Vitals (LCP, CLS, INP, FCP, TTFB) with percentiles |151| `rybbit_get_performance_timeseries` | Web Vitals trends over time |152153### Funnels & Goals154| Tool | Description |155|------|-------------|156| `rybbit_list_funnels` | Saved funnels with step definitions |157| `rybbit_analyze_funnel` | Ad-hoc funnel analysis with custom steps |158| `rybbit_get_funnel_step_sessions` | Sessions that reached or dropped off at a funnel step |159| `rybbit_list_goals` | Goals with conversion metrics |160| `rybbit_get_goal_sessions` | Sessions that completed a specific goal |161162### Journeys163| Tool | Description |164|------|-------------|165| `rybbit_get_journeys` | User navigation path analysis |166167---168169## Common Parameters170171All analytics tools support these optional parameters:172173| Parameter | Type | Description |174|-----------|------|-------------|175| `siteId` | string | Site identifier (required) |176| `startDate` | string | Start date `YYYY-MM-DD` |177| `endDate` | string | End date `YYYY-MM-DD` |178| `timeZone` | string | IANA timezone (e.g., `Europe/Prague`) |179| `filters` | array | Filter array `[{parameter, type, value[]}]` |180| `pastMinutesStart` | number | Minutes ago (alternative to date range) |181182### Filter Parameters183184`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`185186### Filter Types187188`equals`, `not_equals`, `contains`, `not_contains`, `regex`, `not_regex`, `greater_than`, `less_than`189190### Time Buckets191192`minute`, `five_minutes`, `ten_minutes`, `fifteen_minutes`, `hour`, `day`, `week`, `month`, `year`193194---195196## Development197198```bash199# Install dependencies200npm install201202# Build203npm run build204205# Watch mode206npm run dev207208# Type checking209npx tsc --noEmit210```211212---213214## Requirements215216- **Node.js**: 18+217- **Rybbit Analytics**: Self-hosted or cloud instance218219---220221## Contributing222223Contributions are welcome! For major changes, please open an issue first.2242251. Fork the repository2262. Create your feature branch (`git checkout -b feature/amazing-feature`)2273. Commit your changes (`git commit -m 'feat: description'`)2284. Push to the branch (`git push origin feature/amazing-feature`)2295. Open a Pull Request230231## Support232233- 📧 **Email:** dev@nks-hub.cz234- 🐛 **Bug reports:** [GitHub Issues](https://github.com/nks-hub/rybbit-mcp/issues)235- 📖 **MCP Protocol:** [modelcontextprotocol.io](https://modelcontextprotocol.io/)236237## License238239MIT License — see [LICENSE](LICENSE) for details.240241---242243## Links244245- [Rybbit Analytics](https://github.com/rybbit-io/rybbit)246- [npm Package](https://www.npmjs.com/package/@nks-hub/rybbit-mcp)247- [@nks-hub/rybbit-ts](https://github.com/nks-hub/rybbit-ts) — TypeScript tracking SDK248- [rybbit-flutter-sdk](https://github.com/nks-hub/rybbit-flutter-sdk) — Flutter/Dart tracking SDK249250---251252<p align="center">253 Made with ❤️ by <a href="https://github.com/nks-hub">NKS Hub</a>254</p>255
Full transparency — inspect the skill content before installing.