featurely-mcp 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Featurely MCP Server
+ * Gives AI assistants (Claude, Cursor, Windsurf, etc.) complete knowledge
+ * of all four Featurely SDK packages:
+ *   - featurely-error-tracker
+ *   - featurely-feature-reporter
+ *   - featurely-site-manager
+ *   - featurely-i18n
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG"}

package/dist/index.js

@@ -0,0 +1,886 @@
+#!/usr/bin/env node
+/**
+ * Featurely MCP Server
+ * Gives AI assistants (Claude, Cursor, Windsurf, etc.) complete knowledge
+ * of all four Featurely SDK packages:
+ *   - featurely-error-tracker
+ *   - featurely-feature-reporter
+ *   - featurely-site-manager
+ *   - featurely-i18n
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+// ─── Documentation corpus ────────────────────────────────────────────────────
+const DOCS = {
+    "error-tracker": {
+        overview: `featurely-error-tracker — Advanced Error Tracking SDK
+
+Track errors in your applications with automatic breadcrumbs, device info,
+toast notifications, performance monitoring, and complete context for reproduction.
+
+NPM: https://www.npmjs.com/package/featurely-error-tracker
+Install: npm install featurely-error-tracker
+Required API key permission: errors:write`,
+        installation: `# Installation
+
+npm install featurely-error-tracker
+
+## Quick Start
+1. Get your API key from the Featurely dashboard → Settings → API Keys
+2. Create a key with \`errors:write\` permission
+3. Initialize the tracker in your app entry point:
+
+\`\`\`ts
+import { ErrorTracker } from 'featurely-error-tracker';
+
+const tracker = new ErrorTracker({
+  apiKey: 'ft_live_your_api_key_here',
+  environment: 'production',
+  appVersion: '1.0.0',
+});
+
+tracker.install(); // Registers global error/unhandledrejection handlers
+tracker.setUser(user.id, user.email); // Call after login
+\`\`\``,
+        apiReference: `# ErrorTracker — Full API Reference
+
+## Constructor
+
+\`\`\`ts
+new ErrorTracker(config: ErrorTrackerConfig)
+\`\`\`
+
+### ErrorTrackerConfig
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| apiKey | string | ✅ | API key with errors:write permission |
+| environment | string | ✅ | 'development' | 'staging' | 'production' |
+| appVersion | string | ✅ | Semantic version of your app |
+| toast | ToastConfig | ❌ | Visual error alerts (see below) |
+| performance | PerformanceConfig | ❌ | Web Vitals tracking |
+| offline | OfflineConfig | ❌ | Queue errors when offline |
+| privacy | PrivacyConfig | ❌ | PII scrubbing |
+
+### ToastConfig
+\`\`\`ts
+{
+  enabled: boolean;           // Show toast on errors
+  position: 'top-left' | 'top-center' | 'top-right'
+           | 'bottom-left' | 'bottom-center' | 'bottom-right';
+  duration: number;           // ms; 0 = no auto-dismiss
+  showOnAutoCapture: boolean; // Show for automatically caught errors
+}
+\`\`\`
+
+### PerformanceConfig
+\`\`\`ts
+{
+  enabled: boolean;       // Enable performance monitoring
+  trackWebVitals: boolean;// Track LCP, FCP automatically
+  sendWithErrors: boolean;// Attach perf data to error reports
+}
+\`\`\`
+
+### OfflineConfig
+\`\`\`ts
+{
+  enabled: boolean;
+  maxQueueSize: number;           // Max errors to queue (default: 50)
+  storage: 'localStorage' | 'memory';
+}
+\`\`\`
+
+### PrivacyConfig
+\`\`\`ts
+{
+  scrubPII: boolean;             // Auto-remove emails, cards, SSNs, phones
+  scrubQueryParams: string[];    // URL params to remove (e.g. ['token','apiKey'])
+  customPatterns: RegExp[];      // Additional regex patterns to scrub
+}
+\`\`\`
+
+## Methods
+
+### tracker.install()
+Registers global handlers for \`window.onerror\` and \`unhandledrejection\`.
+Call once in your app entry point.
+
+### tracker.setUser(userId: string, email?: string)
+Associate subsequent error reports with a user.
+
+### tracker.reportError(error: Error, severity: Severity, context?: object): Promise<void>
+Manually report an error.
+- severity: 'low' | 'medium' | 'high' | 'critical'
+
+### tracker.showToast(options: ToastOptions): void
+Show a manual toast notification.
+\`\`\`ts
+tracker.showToast({
+  message: 'Data saved!',
+  style: 'success', // 'error' | 'warning' | 'success' | 'info'
+  position: 'top-right',
+  duration: 3000,
+  closable: true,
+});
+\`\`\`
+
+### tracker.trackPerformance(label: string, startTime: number): void
+Track a custom performance metric.
+
+### tracker.destroy(): void
+Remove global handlers and clean up.`,
+        examples: `# Code Examples
+
+## Basic Setup (Vanilla JS / TypeScript)
+\`\`\`ts
+import { ErrorTracker } from 'featurely-error-tracker';
+
+const tracker = new ErrorTracker({
+  apiKey: 'ft_live_your_api_key_here',
+  environment: 'production',
+  appVersion: '1.0.0',
+});
+tracker.install();
+\`\`\`
+
+## Manual Error Reporting
+\`\`\`ts
+try {
+  await riskyOperation();
+} catch (error) {
+  await tracker.reportError(error, 'high', {
+    userId: user.id,
+    action: 'risky_operation',
+  });
+}
+\`\`\`
+
+## With Toast Notifications
+\`\`\`ts
+const tracker = new ErrorTracker({
+  apiKey: 'ft_live_your_api_key_here',
+  environment: 'production',
+  appVersion: '1.0.0',
+  toast: {
+    enabled: true,
+    position: 'top-right',
+    duration: 5000,
+    showOnAutoCapture: true,
+  },
+});
+tracker.install();
+\`\`\`
+
+## With All Advanced Features
+\`\`\`ts
+const tracker = new ErrorTracker({
+  apiKey: 'ft_live_your_api_key_here',
+  environment: 'production',
+  appVersion: '1.0.0',
+  performance: {
+    enabled: true,
+    trackWebVitals: true,
+    sendWithErrors: true,
+  },
+  offline: {
+    enabled: true,
+    maxQueueSize: 50,
+    storage: 'localStorage',
+  },
+  privacy: {
+    scrubPII: true,
+    scrubQueryParams: ['token', 'apiKey', 'password', 'secret'],
+    customPatterns: [/api[_-]?key/gi],
+  },
+});
+tracker.install();
+\`\`\`
+
+## React Integration
+\`\`\`tsx
+'use client';
+import { useEffect } from 'react';
+import { ErrorTracker } from 'featurely-error-tracker';
+
+let tracker: ErrorTracker | null = null;
+
+export function ErrorTrackerProvider({ children, user }) {
+  useEffect(() => {
+    if (!tracker) {
+      tracker = new ErrorTracker({
+        apiKey: process.env.NEXT_PUBLIC_FEATURELY_API_KEY!,
+        environment: process.env.NODE_ENV,
+        appVersion: process.env.NEXT_PUBLIC_APP_VERSION ?? '1.0.0',
+      });
+      tracker.install();
+    }
+    if (user) tracker.setUser(user.id, user.email);
+    return () => { tracker?.destroy(); tracker = null; };
+  }, [user]);
+
+  return <>{children}</>;
+}
+\`\`\``,
+    },
+    "feature-reporter": {
+        overview: `featurely-feature-reporter — Embeddable Feedback Widget
+
+Embeddable widget for collecting user feature requests and bug reports.
+Beautiful UI, screenshot capture, customizable colors, seamless Featurely dashboard integration.
+
+NPM: https://www.npmjs.com/package/featurely-feature-reporter
+Install: npm install featurely-feature-reporter
+Required API key permission: features:write`,
+        installation: `# Installation
+
+npm install featurely-feature-reporter
+
+## Quick Start
+1. Get your API key from the Featurely dashboard → Settings → API Keys
+2. Create a key with \`features:write\` permission
+3. Find your project ID in the Featurely dashboard URL
+4. Initialize the widget:
+
+\`\`\`ts
+import { FeatureReporter } from 'featurely-feature-reporter';
+
+const reporter = new FeatureReporter({
+  apiKey: 'ft_live_your_api_key_here',
+  projectId: 'your-project-id',
+  position: 'bottom-right',
+  color: 'blue',
+});
+reporter.init();
+\`\`\``,
+        apiReference: `# FeatureReporter — Full API Reference
+
+## Constructor
+
+\`\`\`ts
+new FeatureReporter(config: FeatureReporterConfig)
+\`\`\`
+
+### FeatureReporterConfig
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| apiKey | string | ✅ | API key with features:write permission |
+| projectId | string | ✅ | Your Featurely project ID |
+| position | Position | ❌ | Widget placement (default: 'bottom-right') |
+| color | Color | ❌ | Widget color theme (default: 'blue') |
+| icon | Icon | ❌ | Widget button icon (default: 'comment') |
+| draggable | boolean | ❌ | Allow users to drag widget |
+| enableFeatureRequests | boolean | ❌ | Show feature request form (default: true) |
+| enableBugReports | boolean | ❌ | Show bug report form (default: true) |
+| showDashboardLink | boolean | ❌ | Show link to public board (default: false) |
+| labels | LabelsConfig | ❌ | Custom text overrides |
+| onSubmit | function | ❌ | Callback on submission |
+| onError | function | ❌ | Callback on error |
+
+### Position options
+'bottom-right' | 'bottom-left' | 'top-right' | 'top-left' | 'right-center' | 'left-center'
+
+### Color options
+'blue' | 'green' | 'purple' | 'red' | 'orange' | 'pink'
+
+### Icon options
+'comment' | 'lightbulb' | 'bug' | 'message' | 'plus' | 'star'
+
+### LabelsConfig
+\`\`\`ts
+{
+  widgetTooltip?: string;         // Default: 'Feedback'
+  featureRequestTitle?: string;   // Default: 'Request a Feature'
+  bugReportTitle?: string;        // Default: 'Report a Bug'
+  submitButton?: string;          // Default: 'Send'
+  cancelButton?: string;          // Default: 'Cancel'
+}
+\`\`\`
+
+## Methods
+
+### reporter.init(): void
+Mount and render the widget on the page. Call once.
+
+### reporter.setUser(userId: string, email?: string, name?: string): void
+Associate submissions with a user. Call after login.
+
+### reporter.show(): void
+Programmatically show the widget button.
+
+### reporter.hide(): void
+Programmatically hide the widget button.
+
+### reporter.destroy(): void
+Remove the widget from the DOM. Call before unmounting.`,
+        examples: `# Code Examples
+
+## Basic Setup
+\`\`\`ts
+import { FeatureReporter } from 'featurely-feature-reporter';
+
+const reporter = new FeatureReporter({
+  apiKey: 'ft_live_your_api_key_here',
+  projectId: 'your-project-id',
+  position: 'bottom-right',
+  color: 'blue',
+});
+reporter.init();
+reporter.setUser(user.id, user.email, user.name);
+\`\`\`
+
+## Fully Customised
+\`\`\`ts
+const reporter = new FeatureReporter({
+  apiKey: 'ft_live_your_api_key_here',
+  projectId: 'your-project-id',
+  position: 'bottom-right',
+  color: 'purple',
+  icon: 'lightbulb',
+  draggable: true,
+  enableFeatureRequests: true,
+  enableBugReports: true,
+  labels: {
+    widgetTooltip: 'Feedback',
+    featureRequestTitle: 'Suggest a Feature',
+    bugReportTitle: 'Report a Problem',
+    submitButton: 'Send Feedback',
+  },
+  onSubmit: (type, data) => {
+    console.log(\`\${type} submitted\`, data);
+  },
+});
+reporter.init();
+\`\`\`
+
+## React Integration (Next.js App Router)
+\`\`\`tsx
+'use client';
+import { useEffect } from 'react';
+import { FeatureReporter } from 'featurely-feature-reporter';
+
+let reporter: FeatureReporter | null = null;
+
+export function FeedbackWidget({ user }) {
+  useEffect(() => {
+    if (!reporter) {
+      reporter = new FeatureReporter({
+        apiKey: process.env.NEXT_PUBLIC_FEATURELY_API_KEY!,
+        projectId: process.env.NEXT_PUBLIC_PROJECT_ID!,
+        position: 'bottom-right',
+        color: 'blue',
+      });
+      reporter.init();
+    }
+    if (user) reporter.setUser(user.id, user.email, user.name);
+    return () => { reporter?.destroy(); reporter = null; };
+  }, [user]);
+
+  return null; // Widget renders itself into document.body
+}
+\`\`\``,
+    },
+    "site-manager": {
+        overview: `featurely-site-manager — Comprehensive Site Management SDK
+
+Maintenance mode, status messages, feature flags, A/B testing, version management,
+and analytics. Control your app's features and communicate with users from the Featurely dashboard.
+
+NPM: https://www.npmjs.com/package/featurely-site-manager
+Install: npm install featurely-site-manager
+Required API key permission: public:read
+Bundle size: ESM 25.53 KB`,
+        installation: `# Installation
+
+npm install featurely-site-manager
+
+## Quick Start
+1. Get your API key from the Featurely dashboard → Settings → API Keys
+2. Create a key with \`public:read\` permission
+3. Configure maintenance/flags/messages in Settings → Site Management
+4. Initialize the manager:
+
+\`\`\`ts
+import { SiteManager } from 'featurely-site-manager';
+
+const manager = new SiteManager({
+  apiKey: 'ft_live_your_api_key_here',
+  projectId: 'your-project-id',
+  pollInterval: 60000, // Check every 60s
+});
+await manager.init();
+\`\`\``,
+        apiReference: `# SiteManager — Full API Reference
+
+## Constructor
+
+\`\`\`ts
+new SiteManager(config: SiteManagerConfig)
+\`\`\`
+
+### SiteManagerConfig
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| apiKey | string | ✅ | API key with public:read permission |
+| projectId | string | ✅ | Your Featurely project ID |
+| apiUrl | string | ❌ | Custom API base URL |
+| pollInterval | number | ❌ | Update check interval ms (default: 60000) |
+| userEmail | string | ❌ | For maintenance whitelist check |
+| userId | string | ❌ | For feature flag bucketing & analytics |
+| enableAnalytics | boolean | ❌ | Track events (default: true) |
+| analyticsFlushInterval | number | ❌ | Send events interval ms (default: 60000) |
+| appVersion | string | ❌ | Current version for version-check |
+| enableVersionCheck | boolean | ❌ | Enable version polling (default: false) |
+| versionCheckInterval | number | ❌ | Version check interval ms (default: 3600000) |
+| bypassCheck | () => boolean | ❌ | Custom maintenance bypass logic |
+| onMaintenanceEnabled | (config) => void | ❌ | Callback when maintenance starts |
+| onMaintenanceDisabled | () => void | ❌ | Callback when maintenance ends |
+| onMessageReceived | (message) => void | ❌ | Callback for new status messages |
+| onMessageDismissed | (id) => void | ❌ | Callback when message dismissed |
+| onFeatureFlagsUpdated | (flags) => void | ❌ | Callback when flags change |
+| onUpdateAvailable | (info) => void | ❌ | Callback when newer version available |
+| onUpdateRequired | (info) => void | ❌ | Callback when update is mandatory |
+| onError | (error) => void | ❌ | Global error callback |
+
+## Methods
+
+### manager.init(): Promise<void>
+Initialize and start polling. Must be awaited.
+
+### manager.isInMaintenanceMode(): boolean
+Returns true if maintenance mode is currently active.
+
+### manager.getActiveMessages(): StatusMessage[]
+Returns all currently active status messages.
+- StatusMessage: { id, type: 'info'|'warning'|'error'|'success', content, position: 'top'|'bottom', style: 'banner'|'toast', priority }
+
+### manager.isFeatureEnabled(flagKey: string): boolean
+Returns true if the feature flag is enabled for the current user/session.
+
+### manager.getFeatureVariant(flagKey: string): string | null
+Returns the A/B variant string for the flag, or null if not in experiment.
+
+### manager.getAllFeatureFlags(): FeatureFlag[]
+Returns all feature flags (enabled and disabled).
+
+### manager.getEnabledFeatures(): string[]
+Returns array of enabled flag keys.
+
+### manager.trackEvent(name: string, properties?: Record<string, unknown>): void
+Track a custom analytics event. Batched and sent on flush interval.
+
+### manager.refresh(): Promise<void>
+Manually trigger a configuration poll immediately.
+
+### manager.destroy(): void
+Stop polling and flush pending analytics. Call before unmounting.`,
+        examples: `# Code Examples
+
+## Basic Setup
+\`\`\`ts
+import { SiteManager } from 'featurely-site-manager';
+
+const manager = new SiteManager({
+  apiKey: 'ft_live_your_api_key_here',
+  projectId: 'your-project-id',
+  userEmail: user?.email,
+  userId: user?.id,
+});
+await manager.init();
+\`\`\`
+
+## Feature Flags
+\`\`\`ts
+// Check if feature is enabled
+if (manager.isFeatureEnabled('new-checkout')) {
+  renderNewCheckout();
+}
+
+// A/B testing
+const variant = manager.getFeatureVariant('checkout-flow');
+if (variant === 'variant-a') {
+  renderVariantA();
+} else {
+  renderVariantB();
+}
+
+// Get all enabled flags
+const enabled = manager.getEnabledFeatures();
+console.log('Active features:', enabled);
+\`\`\`
+
+## Maintenance Mode
+\`\`\`ts
+const manager = new SiteManager({
+  apiKey: 'ft_live_your_api_key_here',
+  projectId: 'your-project-id',
+  userEmail: user?.email,
+  onMaintenanceEnabled: (config) => {
+    router.push('/maintenance');
+  },
+  onMaintenanceDisabled: () => {
+    router.push('/');
+  },
+});
+await manager.init();
+
+const isMaintenance = manager.isInMaintenanceMode();
+\`\`\`
+
+## Status Messages
+\`\`\`ts
+const manager = new SiteManager({
+  apiKey: 'ft_live_your_api_key_here',
+  projectId: 'your-project-id',
+  onMessageReceived: (message) => {
+    showBanner(message.content, message.type);
+  },
+});
+await manager.init();
+
+const messages = manager.getActiveMessages();
+\`\`\`
+
+## Analytics
+\`\`\`ts
+// Track custom events
+manager.trackEvent('checkout_started', { cartValue: 99.99 });
+manager.trackEvent('button_clicked', { button: 'signup', page: '/home' });
+\`\`\`
+
+## Version Checking
+\`\`\`ts
+const manager = new SiteManager({
+  apiKey: 'ft_live_your_api_key_here',
+  projectId: 'your-project-id',
+  appVersion: '1.2.3',
+  enableVersionCheck: true,
+  onUpdateRequired: (info) => {
+    alert(\`Update required! Please upgrade to \${info.latestVersion.version}\`);
+  },
+  onUpdateAvailable: (info) => {
+    console.log('New version available:', info.latestVersion.version);
+  },
+});
+await manager.init();
+\`\`\`
+
+## React Integration (Next.js)
+\`\`\`tsx
+'use client';
+import { useEffect } from 'react';
+import { SiteManager } from 'featurely-site-manager';
+
+let manager: SiteManager | null = null;
+
+export function SiteManagerProvider({ children, user }) {
+  useEffect(() => {
+    if (!manager) {
+      manager = new SiteManager({
+        apiKey: process.env.NEXT_PUBLIC_FEATURELY_API_KEY!,
+        projectId: process.env.NEXT_PUBLIC_PROJECT_ID!,
+        userEmail: user?.email,
+        userId: user?.id,
+      });
+      manager.init();
+    }
+    return () => { manager?.destroy(); manager = null; };
+  }, [user]);
+
+  return <>{children}</>;
+}
+\`\`\``,
+    },
+    "i18n": {
+        overview: `featurely-i18n — Lightweight i18n Client
+
+Fetch and cache translation keys from your Featurely project.
+Manage all translations in the dashboard, serve via public API with ETag-based caching.
+
+NPM: https://www.npmjs.com/package/featurely-i18n
+Install: npm install featurely-i18n
+Required API key permission: public:read`,
+        installation: `# Installation
+
+npm install featurely-i18n
+
+## Quick Start
+1. Add translation keys in Featurely dashboard → Translations
+2. Get your API key from Settings → API Keys with \`public:read\` permission
+3. Initialize and load:
+
+\`\`\`ts
+import { FeaturelyI18n } from 'featurely-i18n';
+
+const i18n = new FeaturelyI18n({
+  apiKey: 'ft_live_your_api_key_here',
+  locale: 'en',
+  fallbackLocale: 'en',
+});
+await i18n.load();
+
+const label = i18n.t('button.submit');          // "Submit"
+const msg = i18n.t('greeting', { name: 'Ada' }); // "Hello, Ada!"
+\`\`\``,
+        apiReference: `# FeaturelyI18n — Full API Reference
+
+## Constructor
+
+\`\`\`ts
+new FeaturelyI18n(config: FeaturelyI18nConfig)
+\`\`\`
+
+### FeaturelyI18nConfig
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| apiKey | string | ✅ | API key with public:read permission |
+| locale | string | ✅ | Active locale (e.g. 'en', 'nb', 'de') |
+| fallbackLocale | string | ❌ | Used when a key is missing in active locale |
+
+## Properties
+
+### i18n.locale: string
+The currently active locale.
+
+### i18n.translations: Record<string, string>
+All loaded translation key-value pairs for the active locale.
+
+## Methods
+
+### i18n.load(): Promise<void>
+Fetch translations from the API. Respects ETag — returns immediately if nothing changed.
+Always call this before using \`t()\`.
+
+### i18n.t(key: string, variables?: Record<string, string | number>): string
+Translate a key. Supports \`{variable}\` interpolation.
+Falls back to fallbackLocale if key is missing. Returns the key itself if not found anywhere.
+
+### i18n.setLocale(locale: string): Promise<void>
+Switch locale and automatically reload translations.
+
+## Direct REST API
+
+\`\`\`
+GET /api/public/v1/translations?locale={locale}
+Headers: X-API-Key: ft_live_...
+\`\`\`
+
+Response: \`{ translations: Record<string, string>, hash: string, locale: string }\`
+
+Use \`hash\` as \`If-None-Match\` header on subsequent requests.
+Returns \`304 Not Modified\` when nothing has changed (no body).`,
+        examples: `# Code Examples
+
+## Basic Usage
+\`\`\`ts
+import { FeaturelyI18n } from 'featurely-i18n';
+
+const i18n = new FeaturelyI18n({
+  apiKey: 'ft_live_your_api_key_here',
+  locale: 'en',
+  fallbackLocale: 'en',
+});
+await i18n.load();
+
+i18n.t('button.submit');                       // "Submit"
+i18n.t('greeting', { name: 'Ada' });           // "Hello, Ada!"
+i18n.t('items.count', { count: 5 });           // "5 items"
+\`\`\`
+
+## Locale Switching
+\`\`\`ts
+await i18n.setLocale('nb'); // Fetches Norwegian translations
+console.log(i18n.locale);   // "nb"
+console.log(i18n.translations); // { "button.submit": "Send inn", ... }
+\`\`\`
+
+## Direct API (with ETag caching)
+\`\`\`ts
+// First request — fetches all translations
+const res = await fetch('/api/public/v1/translations?locale=en', {
+  headers: { 'X-API-Key': 'ft_live_your_api_key_here' },
+});
+const { translations, hash } = await res.json();
+
+// Subsequent requests — 304 if nothing changed
+const cached = await fetch('/api/public/v1/translations?locale=en', {
+  headers: {
+    'X-API-Key': 'ft_live_your_api_key_here',
+    'If-None-Match': hash,
+  },
+});
+// cached.status === 304 → use previously fetched translations
+\`\`\`
+
+## React Integration
+\`\`\`tsx
+'use client';
+import { createContext, useContext, useEffect, useState } from 'react';
+import { FeaturelyI18n } from 'featurely-i18n';
+
+const i18n = new FeaturelyI18n({
+  apiKey: process.env.NEXT_PUBLIC_FEATURELY_API_KEY!,
+  locale: 'en',
+  fallbackLocale: 'en',
+});
+
+const I18nContext = createContext(i18n);
+
+export function I18nProvider({ children, locale = 'en' }) {
+  const [ready, setReady] = useState(false);
+  useEffect(() => {
+    i18n.setLocale(locale).then(() => setReady(true));
+  }, [locale]);
+  if (!ready) return null;
+  return <I18nContext.Provider value={i18n}>{children}</I18nContext.Provider>;
+}
+
+export function useTranslation() {
+  const i18n = useContext(I18nContext);
+  return { t: i18n.t.bind(i18n), locale: i18n.locale };
+}
+
+// Usage:
+// const { t } = useTranslation();
+// <button>{t('button.submit')}</button>
+\`\`\`
+
+## Next.js Server Component (SSR)
+\`\`\`ts
+// app/[locale]/layout.tsx
+import { FeaturelyI18n } from 'featurely-i18n';
+
+async function getTranslations(locale: string) {
+  const i18n = new FeaturelyI18n({
+    apiKey: process.env.FEATURELY_API_KEY!,
+    locale,
+  });
+  await i18n.load();
+  return i18n.translations;
+}
+
+export default async function RootLayout({ children, params }) {
+  const translations = await getTranslations(params.locale);
+  return <html><body>{children}</body></html>;
+}
+\`\`\``,
+    },
+};
+const PACKAGE_IDS = Object.keys(DOCS);
+const PACKAGES_OVERVIEW = `# Featurely SDK Packages — Overview
+
+Featurely provides four SDK packages for integrating with the Featurely platform:
+
+## 1. featurely-error-tracker
+Track errors automatically with breadcrumbs, device info, performance monitoring,
+PII scrubbing, and offline queuing. Toast notifications for visual alerts.
+- Install: \`npm install featurely-error-tracker\`
+- Permission needed: \`errors:write\`
+- Main class: \`ErrorTracker\`
+
+## 2. featurely-feature-reporter
+Embeddable feedback widget — collects feature requests and bug reports from users.
+Screenshot capture, 6 positions, 6 color themes, fully customisable labels.
+- Install: \`npm install featurely-feature-reporter\`
+- Permission needed: \`features:write\`
+- Main class: \`FeatureReporter\`
+
+## 3. featurely-site-manager
+Control your app remotely: maintenance mode, status banners, feature flags,
+A/B testing, version management, and analytics tracking. Polls for updates.
+- Install: \`npm install featurely-site-manager\`
+- Permission needed: \`public:read\`
+- Main class: \`SiteManager\`
+
+## 4. featurely-i18n
+Lightweight i18n client — fetch and cache translations from Featurely by locale.
+ETag-based caching, variable interpolation, runtime locale switching.
+- Install: \`npm install featurely-i18n\`
+- Permission needed: \`public:read\`
+- Main class: \`FeaturelyI18n\`
+
+## All packages require:
+- A Featurely account and project at https://featurely.no
+- An API key from Settings → API Keys in the dashboard
+- Node.js ≥ 14 (≥ 18 for server-side usage)
+- TypeScript support is built-in (full type definitions included)
+`;
+// ─── MCP Server ───────────────────────────────────────────────────────────────
+const server = new McpServer({
+    name: "featurely",
+    version: "1.0.0",
+});
+// Resource: overview of all packages
+server.resource("packages-overview", "featurely://packages", async () => ({
+    contents: [
+        {
+            uri: "featurely://packages",
+            mimeType: "text/markdown",
+            text: PACKAGES_OVERVIEW,
+        },
+    ],
+}));
+// Resource: one per package
+for (const pkgId of PACKAGE_IDS) {
+    const pkg = DOCS[pkgId];
+    server.resource(`package-${pkgId}`, `featurely://${pkgId}`, async () => ({
+        contents: [
+            {
+                uri: `featurely://${pkgId}`,
+                mimeType: "text/markdown",
+                text: [
+                    pkg.overview,
+                    pkg.installation,
+                    pkg.apiReference,
+                    pkg.examples,
+                ].join("\n\n---\n\n"),
+            },
+        ],
+    }));
+}
+// Tool: list all packages
+server.tool("list_packages", "List all Featurely SDK packages with a short description and install command. Use this first to discover what's available.", {}, async () => ({
+    content: [{ type: "text", text: PACKAGES_OVERVIEW }],
+}));
+// Tool: full docs for one package
+server.tool("get_package_docs", "Get complete documentation for a specific Featurely SDK package, including overview, installation, full API reference, and code examples.", {
+    package: z
+        .enum(["error-tracker", "feature-reporter", "site-manager", "i18n"])
+        .describe("Which package: 'error-tracker' (track errors), 'feature-reporter' (feedback widget), 'site-manager' (feature flags / maintenance / messages), 'i18n' (translations)"),
+}, async ({ package: pkg }) => {
+    const d = DOCS[pkg];
+    const text = [d.overview, d.installation, d.apiReference, d.examples].join("\n\n---\n\n");
+    return { content: [{ type: "text", text }] };
+});
+// Tool: installation guide only
+server.tool("get_installation_guide", "Get the installation and quick-start guide for a Featurely SDK package.", {
+    package: z
+        .enum(["error-tracker", "feature-reporter", "site-manager", "i18n"])
+        .describe("Which package to get installation steps for."),
+}, async ({ package: pkg }) => ({
+    content: [{ type: "text", text: DOCS[pkg].installation }],
+}));
+// Tool: API reference only
+server.tool("get_api_reference", "Get the full API reference (constructor config, all methods, all types) for a Featurely SDK package.", {
+    package: z
+        .enum(["error-tracker", "feature-reporter", "site-manager", "i18n"])
+        .describe("Which package API to look up."),
+}, async ({ package: pkg }) => ({
+    content: [{ type: "text", text: DOCS[pkg].apiReference }],
+}));
+// Tool: code examples
+server.tool("get_code_examples", "Get runnable code examples for a Featurely SDK package. Includes basic setup, framework integrations (React, Next.js), and advanced usage patterns.", {
+    package: z
+        .enum(["error-tracker", "feature-reporter", "site-manager", "i18n"])
+        .describe("Which package to get examples for."),
+}, async ({ package: pkg }) => ({
+    content: [{ type: "text", text: DOCS[pkg].examples }],
+}));
+// ─── Start ────────────────────────────────────────────────────────────────────
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "featurely-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for all Featurely SDK packages — gives AI assistants full knowledge of featurely-error-tracker, featurely-feature-reporter, featurely-site-manager, and featurely-i18n",
+  "type": "module",
+  "bin": {
+    "featurely-mcp": "./dist/index.js"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "featurely",
+    "ai",
+    "llm",
+    "claude",
+    "cursor",
+    "sdk-docs"
+  ],
+  "author": "Featurely",
+  "license": "MIT",
+  "homepage": "https://featurely.no",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0",
+    "@types/node": "^20.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}