featurely-mcp

MCP (Model Context Protocol) server that gives AI assistants full knowledge of all Featurely SDK packages. Add it to Claude, Cursor, Windsurf, or any MCP-compatible editor to get accurate, up-to-date documentation for all five SDKs without leaving your editor.

Installation

npm install -g featurely-mcp
# or use npx (no install required)
npx featurely-mcp

Requires Node.js ≥ 18.

Configuration

The server communicates over stdio. Add it to your AI editor's MCP config file.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
%APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "featurely": {
      "command": "npx",
      "args": ["-y", "featurely-mcp"]
    }
  }
}

Cursor

.cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "featurely": {
      "command": "npx",
      "args": ["-y", "featurely-mcp"]
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "featurely": {
      "command": "npx",
      "args": ["-y", "featurely-mcp"]
    }
  }
}

VS Code (Copilot)

.vscode/mcp.json:

{
  "servers": {
    "featurely": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "featurely-mcp"]
    }
  }
}

Tools

Once connected, your AI assistant has access to the following tools:

| Tool | Description | | ------------------------ | ------------------------------------------------------------------------------------------------------- | | list_packages | List all Featurely SDK packages with a short description and install command | | get_package_docs | Get complete documentation for a package: overview, installation, full API reference, and code examples | | get_installation_guide | Get the installation and quick-start guide for a package | | get_api_reference | Get the full API reference (constructor config, all methods, all types) for a package | | get_code_examples | Get runnable code examples including framework integrations (React, Next.js) |

All tools accept a package parameter with one of: "error-tracker", "feature-reporter", "site-manager", "i18n", "logger".

Covered packages

| Package | Description | | ---------------------------- | --------------------------------------------------------------- | | featurely-error-tracker | Automatic error tracking with breadcrumbs and device context | | featurely-feature-reporter | Embeddable feedback widget for feature requests and bug reports | | featurely-site-manager | Maintenance mode, feature flags, A/B testing, and analytics | | featurely-i18n | Translation management with ETag caching and ICU plural forms | | featurely-logger | Structured event logging with batching and flush-on-exit |

Environment Support

Requires Node.js ≥ 18. Communicates over stdio (standard MCP transport).

| Runtime | Supported | | ------------ | -------------------------- | | Node.js ≥ 18 | ✅ | | Bun | ✅ | | Deno | ⚠️ (via npx compatibility) |

Framework Integrations

Claude Code CLI

claude mcp add featurely -- npx -y featurely-mcp

VS Code (GitHub Copilot)

.vscode/mcp.json:

{
  "servers": {
    "featurely": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "featurely-mcp"]
    }
  }
}

Debugging / Local Development

Run the server directly to verify it starts:

npx featurely-mcp
# Server runs on stdio

Test a tool call manually:

echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_packages","arguments":{}}}' \
  | npx featurely-mcp

TypeScript

The server is written in TypeScript and ships type declarations. No public config interface is exported — all configuration is done via the MCP client (your editor's config file).

Accepted package parameter values: "error-tracker", "feature-reporter", "site-manager", "i18n", "logger".

Resources

• npm