Fluent

Provides 100+ ServiceNow metadata resources and 10 SDK commands to assist AI-assisted Fluent development.

typescript

15

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "modesty-fluent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@modesty/fluent-mcp"
      ],
      "env": {
        "SN_AUTH_TYPE": "oauth",
        "SN_INSTANCE_URL": "https://your-instance.service-now.com",
        "FLUENT_MCP_MIN_ERROR_LENGTH": "50",
        "FLUENT_MCP_ENABLE_ERROR_ANALYSIS": "true"
      }
    }
  }
}

You can use Fluent MCP Server to interact with ServiceNow SDK commands, API specs, and code samples through AI-assisted workflows. It provides a structured set of resources, authentication options, and session-aware tooling to streamline fluent app development and troubleshooting across multiple environments.

How to use

You interact with Fluent MCP Server through your MCP client. Start by configuring an MCP server entry in your client, then run commands to initialize, build, and deploy Fluent apps. Use the available SDK commands to access API specs, code examples, and workflow templates. When a command fails, you can rely on AI-powered error analysis to surface root causes, suggested fixes, and prevention tips.

How to install

Prerequisites: Node.js 22.15.1+ and npm 11.4.1+. Ensure you have a current MCP client that can load servers via npx or similar commands.

{
  "mcpServers": {
    "fluent-mcp": {
      "command": "npx",
      "args": ["-y", "@modesty/fluent-mcp"],
      "env": {
        "SN_INSTANCE_URL": "https://your-instance.service-now.com",
        "SN_AUTH_TYPE": "oauth"
      }
    }
  }
}

Additional notes

To test locally, you can run the MCP Inspector with the sample server config:

# Test with MCP Inspector
npx @modelcontextprotocol/inspector npx @modesty/fluent-mcp

# Or integrate into your MCP client configuration as shown above

Configuration and environment

The server supports multi-environment authentication and session-aware workflows. You can choose basic or oauth authentication profiles and manage them per working session. Enable or customize AI error analysis with environment variables as needed.

Troubleshooting and tips

If you encounter errors, check that the working directory for your Fluent app is set in your MCP client configuration. Use the elicitation flow to gather missing project parameters when initializing or converting a Fluent app, and review the error analysis output to identify root causes and recommended fixes.

Available tools

sdk_info

Get SDK version, help, or debug information for Fluent MCP commands

manage_fluent_auth

Manage authentication profiles for Fluent MCP instances (add/list/delete/use, type: basic/oauth)

init_fluent_app

Initialize or convert a ServiceNow Fluent app, with workingDirectory and template options

build_fluent_app

Build the Fluent application with optional debug output

deploy_fluent_app

Deploy the Fluent app to a ServiceNow instance, with optional auth and debug

fluent_transform

Convert XML to Fluent TypeScript code snippets or metadata

download_fluent_dependencies

Download dependencies and type definitions for Fluent projects

download_fluent_app

Download metadata from a ServiceNow instance to your local directory

clean_fluent_app

Clean the output directory for a Fluent project

pack_fluent_app

Create an installable artifact from your Fluent project