Manage ServiceNow metadata, modules, records, and tests using Fluent, a TypeScript-based declarative DSL. Supports all ServiceNow SDK CLI commands.
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.
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.
The MCP server communicates via stdio according to the MCP specification, allowing any compatible MCP client to interact with it.
version,help,debug,upgrade,auth,init,build,install,transform,dependencies@servicenow/sdk auth --add <instance>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 comeExample of prompt to create a new Fluent application:
Create a new Fluent app under ~/Downloads/fluent-app to track employee time off requests
Watch how the MCP server responds to help LLM create auth credential alias, tables (i.e., dictionary, or data model) for time off requests, business rules to handle request approvals, ACLs to control access, Form view to access time off request info, UI Actions to enhance user experience, and more.
Note, use init command to switch to a working directory for existing Fluent (ServiceNow SDK) project, or to create a new one.
| Tool Name | Description | Parameters |
|---|---|---|
version | Get ServiceNow SDK version information | None |
help | Get help information about ServiceNow SDK commands | command: (Optional) The specific command to get help for |
debug | Enable debug mode for ServiceNow SDK commands | command: The command to run with debug mode enabled |
upgrade | Upgrade ServiceNow SDK to the latest version | check: (Optional) Only check for updates without upgrading, debug: (Optional) Enable debug mode |
auth | Authenticate to a ServiceNow instance | add: (Optional) Instance URL to add, type: (Optional) Authentication method, alias: (Optional) Alias for the instance |
init | Initialize a new ServiceNow application | from: (Optional) sys_id or path, appName: App name, packageName: Package name, scopeName: Scope name, auth: (Optional) Authentication alias |
build | Build a ServiceNow application package | source: Path to source files, frozenKeys: (Optional) Whether to use frozen keys |
install | Install a ServiceNow application to an instance | source: (Optional) Package path, reinstall: (Optional) Whether to reinstall, auth: (Optional) Authentication alias, open-browser: (Optional) Open browser after install, info: (Optional) Show info after install |
transform | Transform ServiceNow metadata to Fluent source code | from: (Optional) Path to metadata, directory: (Optional) Package path, preview: (Optional) Preview only, auth: (Optional) Authentication alias |
dependencies | Download application dependencies | directory: (Optional) Package path, auth: (Optional) Authentication alias |
| Tool Name | Description | Parameters |
|---|---|---|
get-api-spec | Get API specification for a ServiceNow metadata type | metadataType: The metadata type to get specifications for |
get-snippet | Get code snippet for a ServiceNow metadata type | metadataType: The metadata type to get snippets for, id: (Optional) Specific snippet ID to retrieve |
get-instruct | Get instructions for a ServiceNow metadata type | metadataType: The metadata type to get instructions for |
get-prompt | Get specialized prompts for ServiceNow Fluent development | promptId: The ID of the prompt to retrieve (e.g., coding_in_fluent) |
list-metadata-types | List all available ServiceNow metadata types | None |
acl: Access Control Listsapplication-menu: Application Menusbusiness-rule: Business Rulesclient-script: Client Scriptscross-scope-privilege: Cross Scope Privilegesform: Formslist: Listsproperty: System Propertiesrole: Rolesscheduled-script: Scheduled Scriptsscript-include: Script Includesscripted-rest: Scripted REST APIstable: Tablesui-action: UI Actionsuser-preference: User Preferencesatf: 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',The MCP server provides access to various resources that enhance the development experience with ServiceNow Fluent SDK. These resources are designed to assist developers and AI models in understanding and implementing ServiceNow features effectively:
All resources follow standardized URI patterns according to the MCP specification:
API Specifications: sn-spec://{metadataType}
sn-spec://business-ruleInstructions: sn-instruct://{metadataType}
sn-instruct://script-includeCode Snippets: sn-snippet://{metadataType}/{snippetId}
sn-snippet://acl/0001Prompts: sn-prompt://{promptId}
sn-prompt://coding_in_fluentResources can be discovered and accessed in two ways:
resources/list method
All resources are returned as Markdown text, which includes:
The MCP server also provides access to specialized prompts that enhance the development experience with ServiceNow Fluent SDK:
| Prompt Name | Description | URI Format |
|---|---|---|
Coding in Fluent | General guide for coding in ServiceNow Fluent | sn-prompt://coding_in_fluent |
The Coding in Fluent prompt includes:
This prompt is particularly useful for developers new to Fluent or those looking for a quick reference on Fluent coding standards.
To configure the Fluent MCP Server for Claude Desktop:
Configure Claude Desktop to use the MCP server:
{
"mcpServers": {
"fluent-mcp": {
"command": "npx",
"args": ["-y", "@modesty/fluent-mcp"]
}
}
}
When testing with Claude Desktop, check the MCP server logs (typically in ~/Library/Logs/Claude/mcp-server-fluent-mcp.log) to see the actual resource requests being processed.
Example usage in Clause Desktop Chat:
Prompt: "I'm building a ServiceNow application for IT asset management. Using Fluent, help me design and implement a domain-driven business rule for the following scenario: When an IT asset (like a laptop) is assigned to an employee, I need to:
Validate the asset is available and not already assigned Update the asset status to 'In Use' Create an audit trail entry Notify the asset manager if it's a high-value asset (>$2000)
Please show me the business rule structure using Fluent's TypeScript API, following SOLID principles. Think of this like designing a service layer in a traditional enterprise application - how would you structure the business logic to be maintainable and testable?"
Prompt: "I have a legacy ServiceNow application with scattered XML customizations that violate SOLID principles. Using Fluent MCP's transform capabilities, help me:
Transform the existing XML-based business rules into modern TypeScript code Refactor the code to follow single responsibility principle Show me how to extract reusable script includes for common operations
Use the transform command to convert my existing 'Incident Management' customizations, then demonstrate how to restructure them using proper separation of concerns - like how you'd refactor a monolithic service into microservices."
Prompt: "Using Fluent MCP tools, help me set up a test-driven development workflow for ServiceNow. I want to:
Create a new application for 'Employee Onboarding' Set up the project structure with proper dependency management Show me how to write ATF tests for business rules before implementing them Demonstrate the build and install process
Think of this like setting up a new Spring Boot project with Maven - show me the equivalent best practices for ServiceNow development using Fluent SDK."
Prompt:
"Help me design and implement a RESTful API for a ServiceNow application using Fluent MCP tools. The API should handle 'Project Management' operations:
GET /projects - list all projects POST /projects - create new project PUT /projects/{id} - update project DELETE /projects/{id} - delete project
Show me how to:
Use the scripted-rest metadata type to define the API endpoints Implement proper error handling and validation Follow REST best practices and HTTP status codes Structure the code using dependency injection patterns
This should be like building a REST controller in Spring Boot - clean, testable, and following OpenAPI standards."
Prompt: "Using all Fluent MCP capabilities, walk me through creating a complete ServiceNow application from scratch. I want to build a 'Vendor Management' system with:
Custom tables for vendors, contracts, and purchase orders Business rules for validation and workflow Client scripts for UI interactions REST APIs for external integration Proper authentication and authorization
Show me the complete development workflow:
Initialize the project with proper structure Set up dependencies and build configuration Implement the domain models and business logic Create the UI components and forms Build and deploy to a development instance
Think of this as building a full-stack application with proper CI/CD pipeline - what would be the ServiceNow equivalent using Fluent SDK?"
Shift + CMD + p to open VS Code command palette, search for MCP: Add Server...NPM Package. (Model Assisted) as the server type.@modesty/fluent-mcp and follow the prompts to complete the setup.~/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}"
}
}
}
Prompt: "Create a UserService script include that depends on a BaseService script include. Show the TypeScript API calls for both, implementing constructor injection pattern. Use get-api-spec script-include to verify the structure."
Prompt: "Configure auth profiles for dev/test/prod environments, then create a build script that deploys to each sequentially. Handle auth failures with rollback. Show the exact manage_fluent_auth and fluent_install commands."
Prompt: "Create 3 client scripts: onChange validation for 'priority' field, onLoad to set field states, onSubmit for final validation. Make them work together using shared utility functions. Use the client-script API spec."
Prompt: "Transform existing business rules from instance using fluent_transform, identify SOLID violations, refactor into separate script includes, then rebuild. Show the complete transform → refactor → build workflow."
Prompt: "Create before/after/async business rules for incident creation with proper error handling, logging, and transaction rollback. Show how to coordinate execution order and handle failures gracefully."
To configure the Fluent MCP Server for Cursor:
Add a new MCP Server with the following configuration:
{
"mcpServers": {
"fluent-mcp": {
"command": "npx",
"args": ["-y", "@modesty/fluent-mcp"]
}
}
}
Example usage in Cursor:
I'm working on a ServiceNow app. Can you show me how to create a UI Action?
To configure the Fluent MCP Server for Windsurf:
CMD + , to open Windsurf settings, and navigate to the Cascade section.
Click Add Server in Model Context Protocol (MCP) Servers section.
Select Add Custom MCP Server + in the Model Context Protocol (MCP) Servers Templates popup.
Paste in the following to mcp_config.json:
{
"mcpServers": {
"fluent-mcp": {
"command": "npx",
"args": ["-y", "@modesty/fluent-mcp"]
}
}
}
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.
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
To configure the Fluent MCP Server for Gemini CLI:
~/.gemini/settings.json./.gemini/settings.json{
"mcpServers": {
"fluent-mcp": {
"command": "npx",
"args": [
"-y",
"@modesty/fluent-mcp"
]
}
}
}
Example usage in Gemini CLI:
show me an example of creating a table with 3 columns, String, Boolean and Reference in Fluent ;
create a business rule to ensure the assigned_to is not null when insert and update for the table created above
MIT
An AI-driven platform for frontend semantic cognition and automation.
Interact with Homebrew (the package manager for macOS and Linux) using natural language commands.
Analyzes your codebase identifying important files based on dependency relationships. Generates diagrams and importance scores per file, helping AI assistants understand the codebase. Automatically parses popular programming languages, Python, Lua, C, C++, Rust, Zig.
Boost security in your dev lifecycle via SAST, SCA, Secrets & IaC scanning with Cycode.
Access and interact with Harness platform data, including pipelines, repositories, logs, and artifact registries.
MCP Server for automated reverse engineering with IDA Pro.
A powerful and flexible MCP server designed to enhance the development experience with Shadcn UI components, providing tools for component management, documentation, and installation.
A collection of reference implementations for the Model Context Protocol (MCP), showcasing various MCP servers implemented with TypeScript and Python SDKs.
Work on dataset metadata with MLCommons Croissant validation and creation.
Connects to the React Native application debugger to retrieve console logs from Metro.