Skip to main content
Glama
FFS MCP Server

FFS MCP Server

by ZhipingYang

FFS MCP Server

MCP (Model Context Protocol) Server for managing FFS (Feature Flag Service).

Features

  • πŸ” ffs_get_user_info: Get AccountId and ExtensionId from RingCentral credentials

  • πŸ” ffs_search_flag: Search for FFS flags by keyword

  • πŸ“‹ ffs_get_flag_options: Get all available options for a Flag

  • βœ… ffs_check_account: Check account status in a Flag

  • ✏️ ffs_update_account: Update account's Flag value

Related MCP server: @shipeasy/mcp

Configuration

The server requires the following environment variables:

Variable

Description

Required

FFS_BASE_URL

FFS API base URL

βœ…

FFS_RC_API_URL

RingCentral API URL

βœ…

FFS_RC_CLIENT_CREDENTIALS

Base64 encoded client credentials

βœ…

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "ffs": {
      "command": "npx",
      "args": ["@xcodeyang/ffs-mcp-server"],
      "env": {
        "FFS_BASE_URL": "http://your-ffs-server:8080",
        "FFS_RC_API_URL": "https://your-rc-api-server",
        "FFS_RC_CLIENT_CREDENTIALS": "your-base64-credentials"
      }
    }
  }
}

Augment (VS Code)

{
  "augment.advanced": {
    "mcpServers": [
      {
        "name": "ffs",
        "command": "npx",
        "args": ["@xcodeyang/ffs-mcp-server"],
        "env": {
          "FFS_BASE_URL": "http://your-ffs-server:8080",
          "FFS_RC_API_URL": "https://your-rc-api-server",
          "FFS_RC_CLIENT_CREDENTIALS": "your-base64-credentials"
        }
      }
    ]
  }
}

Publishing

# Build first
npm run build

# Publish to RingCentral Nexus registry
npm publish

Tools

ffs_get_user_info

Get AccountId and ExtensionId from RingCentral credentials.

Input:

  • username: RingCentral user email

  • password: RingCentral password

Output:

  • accountId: Company-level ID (affects all users in the company)

  • extensionId: User-level ID (affects only this user)

ffs_search_flag

Search for FFS flags by keyword.

Input:

  • keyword: Search keyword or complete Flag ID

ffs_get_flag_options

Get all available options for a Flag.

Input:

  • flagId: Complete FFS Flag ID

Output:

  • List of options with valueId (needed for updates)

ffs_check_account

Check account status in a Flag.

Input:

  • flagId: Complete FFS Flag ID

  • id: AccountId or ExtensionId

ffs_update_account

Update account's Flag value using MCP Auto Condition.

Input:

  • flagId: Complete FFS Flag ID

  • id: AccountId or ExtensionId

  • targetValueId: Value ID from ffs_get_flag_options

Development

# Run in development mode
npm run dev

# Build
npm run build

# Test tools
npx tsx test-tools.ts

Available Tools

5 tools
ffs_check_accountB

Check the current status of an AccountId or ExtensionId in a Flag.

Inputs: flagId (required), id (required).

ffs_get_flag_optionsC

Get all available options (values) for a Flag. Shows Value IDs needed for updates.

Inputs: flagId (required).

ffs_get_user_infoA

Get AccountId and ExtensionId from RingCentral credentials. Use ExtensionId for individual user, AccountId for entire company.

Inputs: username (required), password (required).

ffs_search_flagC

Search for FFS flags by keyword. Returns matching flags with their IDs and types.

Inputs: keyword (required).

ffs_update_accountC

Update an AccountId or ExtensionId to use a specific Flag value. Uses MCP Auto Condition for management.

Inputs: flagId (required), id (required), targetValueId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: checking account status, getting flag options, retrieving user info, searching flags, and updating accounts. There is no overlap in functionality, and the descriptions make the boundaries explicit, preventing agent misselection.

    Naming Consistency5/5

    All tools follow a consistent 'ffs_verb_noun' pattern with snake_case, such as ffs_check_account and ffs_update_account. This predictability makes the tool set easy to navigate and understand at a glance.

    Tool Count5/5

    With 5 tools, the server is well-scoped for managing FFS flags and accounts. Each tool serves a specific, necessary function without redundancy, fitting typical expectations for a focused utility server.

    Completeness4/5

    The tool set covers core CRUD-like operations for FFS management: checking, searching, getting info, and updating. A minor gap exists in not having a tool to create or delete flags, but the available tools support key workflows without dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      An MCP server that allows AI assistants to programmatically manage Unleash feature flags through natural language, enabling operations like creating, updating, and retrieving feature flags across projects.
      5
      7 npm
      3
      ISC
    • A
      license
      Not graded
      quality
      A
      maintenance
      A unified MCP server for experimentation and i18n, enabling AI assistants to manage feature flags, experiments, metrics, events, and string translations via natural language.
      677 npm
      MIT