MCP Server for Fluent (ServiceNow SDK)

A stdio MCP Server for Fluent (ServiceNow SDK), a TypeScript-based declarative domain-specific language for creating and managing metadata, modules, records and tests in ServiceNow platform. It support all commands available in the ServiceNow SDK CLI, and provides access to primary Fluent Plugin's API specifications, code snippets, and instructions for various metadata types. It can be configured for any MCP client, such as VSCode Agent mode, Claude Desktop, Cursor, or Windsurf, for either development or learning purposes.

Description

Fluent (ServiceNow SDK) MCP bridges ServiceNow development tools with modern AI-assisted development environments by implementing the Model Context Protocol. It enables developers and AI assistants to interact with Fluent (ServiceNow SDK) commands and access resources like API specifications, code snippets, and instructions through natural language.

Usage

Using with an MCP Client

The MCP server communicates via stdio according to the MCP specification, allowing any compatible MCP client to interact with it.

Features

• Access to all ServiceNow SDK CLI commands, including:version,help,debug,upgrade,auth,init,build,install,transform,dependencies
• ServiceNow authentication via @servicenow/sdk auth --add <instance>
• Access to API specifications for different metadata types, including acl, application-menu, business-rule, client-script, cross-scope-privilege, form, list, property, role, scheduled-script, script-include, scripted-rest, table, ui-action, user-preference and more to come
• Access to code snippets and examples for different metadata types
• Access to instructions for creating and modifying different metadata types

Available MCP Tools

ServiceNow SDK Command Tools

Note, use init command to switch to a working directory for existing Fluent (ServiceNow SDK) project, or to create a new one.

Resource Tools

Supported Metadata Types

• acl: Access Control Lists
• application-menu: Application Menus
• business-rule: Business Rules
• client-script: Client Scripts
• cross-scope-privilege: Cross Scope Privileges
• form: Forms
• list: Lists
• property: System Properties
• role: Roles
• scheduled-script: Scheduled Scripts
• script-include: Script Includes
• scripted-rest: Scripted REST APIs
• table: Tables
• ui-action: UI Actions
• user-preference: User Preferences
• atf: Automated Test Framework, including 'atf-appnav', 'atf-catalog-action','atf-catalog-validation','atf-catalog-variable','atf-email','atf-form','atf-form-action','atf-form-declarative-action','atf-form-field','atf-reporting','atf-rest-api','atf-rest-assert-payload','atf-server','atf-server-catalog-item','atf-server-record',

Requirements

• Node.js 22.15.1 or later
• npm 11.4.1 or later

Configuring with AI Tools

To configure the Fluent MCP Server for use with VSCode Agent mode (such as with GitHub Copilot or CodeLlama):

VSCode GitHub Copilot Agent Mode

1. Shift + CMD + p to open VS Code command palette, search for MCP: Add Server...
2. Select NPM Package. (Model Assisted) as the server type.
3. Fill in package name as @modesty/fluent-mcp and follow the prompts to complete the setup.
4. Restart VS Code and the agent will now have access to ServiceNow Fluent SDK tools.
5. If any issues arise, ensure the ~/Library/Application Support/Code/User/settings.json file is correctly configured.

"mcp": {
  "servers": {
            "fluent-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@modesty/fluent-mcp"
                ],
                "cwd": "${input:cwd}"
            }
        }
}

Example usage in VS Code Agent Chat:

Please create a business rule for ServiceNow that validates a record before insert.

Claude Desktop / Claude on macOS

To configure the Fluent MCP Server for Claude Desktop:

1. Configure Claude Desktop to use the MCP server:

   • Settings > Developers

   • Add a new MCP Server with configuration:

     {
      "mcpServers": {
        "fluent-mcp": {
          "command": "npx",
          "args": [
            "@modesty/fluent-mcp"
          ]
        }
      }

   }

Example usage in Claude Desktop:

- I need to create a ServiceNow client script that validates a field value. Can you help me with that?

Cursor

To configure the Fluent MCP Server for Cursor:

1. Add a new MCP Server with the following configuration:

   • Open Cursor settings

   • Navigate to MCP Servers

   • Add a new MCP Server with the following configuration:

     {
      "mcpServers": {
        "fluent-mcp": {
          "command": "npx",
          "args": [
            "@modesty/fluent-mcp"
          ]
        }
      }

   } ```

Example usage in Cursor:

I'm working on a ServiceNow app. Can you show me how to create a UI Action?

Windsurf

To configure the Fluent MCP Server for Windsurf:

1. CMD + , to open Windsurf settings, and navigate to the Cascade section.

2. Click Add Server in Model Context Protocol (MCP) Servers section.

3. Select Add Custom MCP Server + in the Model Context Protocol (MCP) Servers Templates popup.

4. Paste in the following to mcp_config.json:

   {
     "mcpServers": {
       "fluent-mcp": {
         "command": "npx",
         "args": [
           "-y",
           "@modesty/fluent-mcp"
         ]
       }
     }
   }

5. After closing the mcp_config.json edit tab, click Refresh in the Model Context Protocol (MCP) Servers section to apply the changes. All tools under fluent-mcp will be listed and available when refreshing is complete.

6. Example usage in Windsurf:

* Show the help on how to authenticate to ServiceNow instance using Fluent
* Authenticate me to http://localhost:8080 with my credentials

License

MIT