Fluent MCP server
Commit Nov 8, 2026Enables AI agents to develop ServiceNow applications using the Fluent SDK through CLI tools, API specifications, and automated security and performance reviews.
Also known as modesty/fluent-mcp, @modesty/fluent-mcp
- Stars
- 33
- Tools
- 16
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 8, 2026
- License
- MIT
What is Fluent MCP?
Fluent enables AI agents to develop ServiceNow applications using the Fluent SDK through CLI tools, API specifications, and automated security and performance reviews. It exposes 16 tools, such as build_fluent_app, check_auth_status, cicd_fluent_app.
Summary generated from the project's README
About Fluent MCP server
Developers building ServiceNow applications can use this server to integrate the ServiceNow Fluent SDK directly into AI-assisted coding environments. It provides a bridge for AI agents to execute CLI commands, access API specifications, and perform automated code reviews. By connecting to a local or remote environment via stdio, the server allows agents to manage the entire application lifecycle from initialization to deployment.
The server includes 16 tools that cover essential tasks such as building, deploying, and transforming metadata using commands like build_fluent_app, deploy_fluent_app, and fluent_transform. It also offers specialized skills for security, performance, and domain separation reviews. To function, it requires Node.js and npm, and it uses environment variables like SN_INSTANCE_URL and SN_AUTH_TYPE to manage authentication. It automatically resolves and caches SDK auth profiles to ensure secure access to ServiceNow instances without manual intervention during every call.
What you can do with it
- 1Converting XML to Fluent SourceYou can instruct an AI to transform existing ServiceNow records or XML files into modern Fluent TypeScript source code.
Written from the project's README. Every use case is checked against a quote from it.
How to install Fluent MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Fluent MCP in Claude Code
$ claude mcp add fluent-mcp -- npx -y @modesty/fluent-mcpInstall Fluent MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"fluent-mcp": {
"command": "npx",
"args": [
"-y",
"@modesty/fluent-mcp"
]
}
}
}Install Fluent MCP in VS Code
.vscode/mcp.json
{
"servers": {
"fluent-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modesty/fluent-mcp"
]
}
}
}Install Fluent MCP in VS Code CLI
$ code --add-mcp '{"name":"fluent-mcp","type":"stdio","command":"npx","args":["-y","@modesty/fluent-mcp"]}'Install Fluent MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"fluent-mcp": {
"command": "npx",
"args": [
"-y",
"@modesty/fluent-mcp"
]
}
}
}Install Fluent MCP in Codex
$ codex mcp add fluent-mcp -- npx -y @modesty/fluent-mcpInstall Fluent MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.fluent-mcp] command = "npx" args = ["-y", "@modesty/fluent-mcp"]
Install Fluent MCP in Gemini CLI
$ gemini mcp add -s user fluent-mcp npx -- -y @modesty/fluent-mcpInstall Fluent MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"fluent-mcp": {
"command": "npx",
"args": [
"-y",
"@modesty/fluent-mcp"
]
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for @modesty/fluent-mcp 0.11.0 in an isolated container with no network and no keys. It answered and listed 16 tools.
Fluent MCP tools 16
Read from the server with tools/listbuild_fluent_appBuild a Fluent (ServiceNow SDK) application package from source code. Requires a valid Fluent project directory with now.config.json. Run after init_fluent_app and before deploy_fluent_app. Does NOT require instance authentication.
check_auth_statusRead-onlyCheck current ServiceNow authentication status. Lazily validates configured auth once and returns JSON including status, profile alias, instance host, auth type, and any required user action. Call this before commands that require authentication (deploy_fluent_app, fluent_transform, download_fluent_dependencies, download_fluent_app) to verify credentials are configured.
cicd_fluent_appRun a ServiceNow app-repo CI/CD operation via the sn_cicd API (SDK v4.10.0+): install, publish, or rollback an application on an instance. CHANGES INSTANCE STATE. Identify the app with either scope or appSysId; inside a Fluent project both appSysId and appVersion default from now.config.json/package.json, and outside one both must be passed explicitly. appVersion is always required for rollback. Requires instance authentication (auto-injected from session, or pass auth explicitly).
cicd_fluent_testRun or inspect ServiceNow ATF tests through the sn_cicd API (SDK v4.10.0+). Set target to "testsuite" or "test" and action to "run" (start it), "watch" (follow a progressId from a previous run), "result" (fetch a resultId), or "logs" (fetch the captured logs of a single test result, optionally filtered by a regex pattern; target="test" only, SDK v4.12.0+). Identify a suite by testSuiteSysId or testSuiteName, a test by testSysId or testName. action="run" executes real ATF steps on the instance and the records those steps touch change; "watch", "result", and "logs" only read. No Fluent project required. Requires instance authentication (auto-injected from session, or pass auth explicitly).
clean_fluent_appDelete the build output directory of a Fluent (ServiceNow SDK) application. This is a destructive operation that removes all compiled artifacts. Run build_fluent_app afterward to regenerate. Does NOT require authentication.
deploy_fluent_appDeploy a built Fluent (ServiceNow SDK) application to a ServiceNow instance. Requires a prior build via build_fluent_app and valid instance authentication (auto-injected from session, or pass auth explicitly). Use skipFlowActivation to prevent auto-publishing of flows and subflows during deployment. Since SDK v4.12.0 the install runs asynchronously by default (the CLI polls the instance until it finishes); set async=false to force a synchronous install.
download_fluent_appDownload application metadata from a ServiceNow instance into a local directory. Includes metadata deployed to the instance that may not exist locally. The directory argument specifies where to expand the application. Use incremental mode to download only changes since the last download. For a large application, raise timeoutSeconds (SDK v4.13.0+). Requires instance authentication (auto-injected from session).
download_fluent_dependenciesDownload configured dependencies from now.config.json and TypeScript type definitions for use in a Fluent application. Requires instance authentication (auto-injected from session, or pass auth explicitly). Supports pulling type definitions for tables and roles outside application scope via dependencies.global configuration. Run this after init_fluent_app to set up type definitions before development.
explain_fluent_apiRead-onlyLook up Fluent SDK documentation for any API or guide. Accepts a topic name (e.g., "BusinessRule", "Acl") or a keyword/tag (e.g., "flow", "atf"). Set list=true to enumerate available topics (optionally combined with topic to filter). Set peek=true for a brief summary. Set format="raw" for plain markdown. Read-only; no authentication or active Fluent project required. Use get_fluent_knowledge for metadata-type specifications, authoring guides and code examples.
fluent_exec_scriptRun a server-side JavaScript script on the authenticated ServiceNow instance, like the Scripts - Background page (SDK v4.14.0+ `now-sdk exec`). The script runs with the authenticated user's full permissions and needs the admin role. BEFORE EVERY CALL: show the user the full script, the target instance, the scope, and the reason, and get their explicit approval for that run; approval of one script never covers another. With file, show the file's full CONTENT, not just its path, and do not edit the file between approval and the call; the result echoes the content and SHA-256 that actually ran. Prefer query_fluent_records for reads and the app's own metadata for anything that should ship with the app. The run is recorded in Script Execution History with a rollback context, but rollback only reverts record changes; emails, REST calls, events and scheduled jobs it triggers cannot be undone. A timeout or cancellation does NOT stop the script on the instance; never retry automatically, or a second copy runs. ok: false with an errors array means the script RAN and threw, possibly after changing records, so a retry runs it again; ok: false with error.message means it never ran (for example an unknown scope). Returns a JSON envelope with ok, output, errors, scope, executionHistoryId, and rollbackContextId (absent when no records changed or the history record is unreadable). Requires instance authentication (auto-injected from session, or pass auth explicitly).
fluent_transformConvert XML metadata into Fluent source code, or pull changes made on a ServiceNow instance back into the project's .now.ts files. Use from for local XML files/directories (offline; cannot be combined with auth or id). Omit from to pull the whole application from the instance (auth auto-injected from session, or pass auth). Use table with id (SDK v4.7.0+) to pull one record and its related records from the instance. table without id only filters local XML (from, or the project directory) to those tables and their descendants — it does not download, though the CLI still requires credentials when from is omitted. For a large full-application pull, raise timeoutSeconds (SDK v4.13.0+). Overwrites local changes to the records it updates.
get_fluent_knowledgeRead-onlyRead Fluent knowledge for a ServiceNow metadata type (e.g., business-rule, script-include). kind 'spec' returns the Fluent API specification, 'instruct' the authoring rules, conventions and pitfalls, and 'snippet' a runnable code example (without snippetId, the first one plus the ids of the others). Omit metadataType to list the metadata types that have that kind. For SDK APIs and guides beyond metadata types, use explain_fluent_api.
| build_fluent_app | Build a Fluent (ServiceNow SDK) application package from source code. Requires a valid Fluent project directory with now.config.json. Run after init_fluent_app and before deploy_fluent_app. Does NOT require instance authentication. | |
| check_auth_status | Check current ServiceNow authentication status. Lazily validates configured auth once and returns JSON including status, profile alias, instance host, auth type, and any required user action. Call this before commands that require authentication (deploy_fluent_app, fluent_transform, download_fluent_dependencies, download_fluent_app) to verify credentials are configured. | Read-only |
| cicd_fluent_app | Run a ServiceNow app-repo CI/CD operation via the sn_cicd API (SDK v4.10.0+): install, publish, or rollback an application on an instance. CHANGES INSTANCE STATE. Identify the app with either scope or appSysId; inside a Fluent project both appSysId and appVersion default from now.config.json/package.json, and outside one both must be passed explicitly. appVersion is always required for rollback. Requires instance authentication (auto-injected from session, or pass auth explicitly). | |
| cicd_fluent_test | Run or inspect ServiceNow ATF tests through the sn_cicd API (SDK v4.10.0+). Set target to "testsuite" or "test" and action to "run" (start it), "watch" (follow a progressId from a previous run), "result" (fetch a resultId), or "logs" (fetch the captured logs of a single test result, optionally filtered by a regex pattern; target="test" only, SDK v4.12.0+). Identify a suite by testSuiteSysId or testSuiteName, a test by testSysId or testName. action="run" executes real ATF steps on the instance and the records those steps touch change; "watch", "result", and "logs" only read. No Fluent project required. Requires instance authentication (auto-injected from session, or pass auth explicitly). | |
| clean_fluent_app | Delete the build output directory of a Fluent (ServiceNow SDK) application. This is a destructive operation that removes all compiled artifacts. Run build_fluent_app afterward to regenerate. Does NOT require authentication. | |
| deploy_fluent_app | Deploy a built Fluent (ServiceNow SDK) application to a ServiceNow instance. Requires a prior build via build_fluent_app and valid instance authentication (auto-injected from session, or pass auth explicitly). Use skipFlowActivation to prevent auto-publishing of flows and subflows during deployment. Since SDK v4.12.0 the install runs asynchronously by default (the CLI polls the instance until it finishes); set async=false to force a synchronous install. | |
| download_fluent_app | Download application metadata from a ServiceNow instance into a local directory. Includes metadata deployed to the instance that may not exist locally. The directory argument specifies where to expand the application. Use incremental mode to download only changes since the last download. For a large application, raise timeoutSeconds (SDK v4.13.0+). Requires instance authentication (auto-injected from session). | |
| download_fluent_dependencies | Download configured dependencies from now.config.json and TypeScript type definitions for use in a Fluent application. Requires instance authentication (auto-injected from session, or pass auth explicitly). Supports pulling type definitions for tables and roles outside application scope via dependencies.global configuration. Run this after init_fluent_app to set up type definitions before development. | |
| explain_fluent_api | Look up Fluent SDK documentation for any API or guide. Accepts a topic name (e.g., "BusinessRule", "Acl") or a keyword/tag (e.g., "flow", "atf"). Set list=true to enumerate available topics (optionally combined with topic to filter). Set peek=true for a brief summary. Set format="raw" for plain markdown. Read-only; no authentication or active Fluent project required. Use get_fluent_knowledge for metadata-type specifications, authoring guides and code examples. | Read-only |
| fluent_exec_script | Run a server-side JavaScript script on the authenticated ServiceNow instance, like the Scripts - Background page (SDK v4.14.0+ `now-sdk exec`). The script runs with the authenticated user's full permissions and needs the admin role. BEFORE EVERY CALL: show the user the full script, the target instance, the scope, and the reason, and get their explicit approval for that run; approval of one script never covers another. With file, show the file's full CONTENT, not just its path, and do not edit the file between approval and the call; the result echoes the content and SHA-256 that actually ran. Prefer query_fluent_records for reads and the app's own metadata for anything that should ship with the app. The run is recorded in Script Execution History with a rollback context, but rollback only reverts record changes; emails, REST calls, events and scheduled jobs it triggers cannot be undone. A timeout or cancellation does NOT stop the script on the instance; never retry automatically, or a second copy runs. ok: false with an errors array means the script RAN and threw, possibly after changing records, so a retry runs it again; ok: false with error.message means it never ran (for example an unknown scope). Returns a JSON envelope with ok, output, errors, scope, executionHistoryId, and rollbackContextId (absent when no records changed or the history record is unreadable). Requires instance authentication (auto-injected from session, or pass auth explicitly). | |
| fluent_transform | Convert XML metadata into Fluent source code, or pull changes made on a ServiceNow instance back into the project's .now.ts files. Use from for local XML files/directories (offline; cannot be combined with auth or id). Omit from to pull the whole application from the instance (auth auto-injected from session, or pass auth). Use table with id (SDK v4.7.0+) to pull one record and its related records from the instance. table without id only filters local XML (from, or the project directory) to those tables and their descendants — it does not download, though the CLI still requires credentials when from is omitted. For a large full-application pull, raise timeoutSeconds (SDK v4.13.0+). Overwrites local changes to the records it updates. | |
| get_fluent_knowledge | Read Fluent knowledge for a ServiceNow metadata type (e.g., business-rule, script-include). kind 'spec' returns the Fluent API specification, 'instruct' the authoring rules, conventions and pitfalls, and 'snippet' a runnable code example (without snippetId, the first one plus the ids of the others). Omit metadataType to list the metadata types that have that kind. For SDK APIs and guides beyond metadata types, use explain_fluent_api. | Read-only |
Show all 16 toolsShow fewer tools
init_fluent_appInitialize a new Fluent (ServiceNow SDK) application or convert an existing scoped application. Set intent to "creation" for a new app (requires appName, packageName, scopeName, template) or "conversion" to convert from an instance sys_id or an absolute local application directory (requires from, and auth for instance conversion; pass packageName too, or the returned command prompts for it). Creation is not offline: the returned command reads the vendor prefix of the auth instance (explicit, else the session alias, else the CLI default profile) and contacts the npm registry. The workingDirectory must be an absolute path to an empty directory, or to a new directory under an existing one. The result is a shell command that enters that directory and runs the SDK init. After init, use build_fluent_app to compile.
pack_fluent_appPackage a built Fluent (ServiceNow SDK) application into a zip artifact for installation. Requires a prior build via build_fluent_app. The output zip can be used for manual installation on a ServiceNow instance. Does NOT require authentication.
query_fluent_recordsRead-onlyRun a read-only query against a ServiceNow table via the Table REST API (SDK v4.8.0+). Returns matching records as a JSON envelope. Requires instance authentication (auto-injected from session, or pass auth explicitly). Provide table and an encoded query (e.g. "active=true^priority<=2"). No Fluent project required.
sdk_infoRead-onlyGet Fluent (ServiceNow SDK) version or help information. Use -v to check the installed SDK version, or -h for general help or help on a specific command (e.g., flag: "-h", command: "build"). Does NOT require authentication or a Fluent project directory.
| init_fluent_app | Initialize a new Fluent (ServiceNow SDK) application or convert an existing scoped application. Set intent to "creation" for a new app (requires appName, packageName, scopeName, template) or "conversion" to convert from an instance sys_id or an absolute local application directory (requires from, and auth for instance conversion; pass packageName too, or the returned command prompts for it). Creation is not offline: the returned command reads the vendor prefix of the auth instance (explicit, else the session alias, else the CLI default profile) and contacts the npm registry. The workingDirectory must be an absolute path to an empty directory, or to a new directory under an existing one. The result is a shell command that enters that directory and runs the SDK init. After init, use build_fluent_app to compile. | |
| pack_fluent_app | Package a built Fluent (ServiceNow SDK) application into a zip artifact for installation. Requires a prior build via build_fluent_app. The output zip can be used for manual installation on a ServiceNow instance. Does NOT require authentication. | |
| query_fluent_records | Run a read-only query against a ServiceNow table via the Table REST API (SDK v4.8.0+). Returns matching records as a JSON envelope. Requires instance authentication (auto-injected from session, or pass auth explicitly). Provide table and an encoded query (e.g. "active=true^priority<=2"). No Fluent project required. | Read-only |
| sdk_info | Get Fluent (ServiceNow SDK) version or help information. Use -v to check the installed SDK version, or -h for general help or help on a specific command (e.g., flag: "-h", command: "build"). Does NOT require authentication or a Fluent project directory. | Read-only |
Configuration
FLUENT_MCP_WORKING_DIRSN_AUTH_TYPESN_INSTANCE_URL
| Name | Description | |
|---|---|---|
| FLUENT_MCP_WORKING_DIR | — | |
| SN_AUTH_TYPE | — | |
| SN_INSTANCE_URL | — |
Automated checks
Ran Nov 16, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablemodesty/fluent-mcp is public and reachablegithub.com/modesty/fluent-mcp ↗Pass
- Package names this repository as its source@modesty/fluent-mcp names modesty/fluent-mcp as sourcenpmjs.com/package/@modesty/fluent-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-08github.com/modesty/fluent-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @modesty/fluent-mcpPass
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model16 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubFluent MCP Server
An MCP server and AI skill suite that brings ServiceNow Fluent SDK (@servicenow/sdk) capabilities, API specifications, code snippets, and security reviews to AI-assisted development environments.
Built for @servicenow/sdk@v4.14.0.
Key Features
- 16 MCP Tools — 14 ServiceNow SDK CLI command tools (
sdk_info,init,build,deploy,transform,dependencies,download,clean,pack,explain,query,cicd_fluent_app,cicd_fluent_test,fluent_exec_script) plus 2 knowledge/auth tools (get_fluent_knowledge,check_auth_status). - 76 ServiceNow Metadata Types — Packaged API specs (
sn-spec://), authoring instructions (sn-instruct://), runnable snippets (sn-snippet://), and workflow prompts (coding_in_fluent,create_custom_ui). - AI Agent Skills — Built-in skills (
fluent-cli,fluent-security-review,fluent-general-review,fluent-perf-review, andfluent-domain-separation-review) installable as a plugin for Claude Code, Codex, Copilot, and other skill-enabled agents. - Lazy Auto-Authentication — Resolves and caches an SDK auth profile matching
SN_INSTANCE_URLon first use. - Explicit Working Directory Resolution — Resolves project paths in strict order:
workingDirectoryargument → session (init_fluent_app) →FLUENT_MCP_WORKING_DIR→ actionable error. Never guesses fromprocess.cwd(). - Dual-Era MCP Protocol — Serves both current and legacy MCP protocol revisions over stdio from a single handler set, with zero server-initiated requests.
MCP Setup
Requirements: Node.js >=22.23.2 and npm >=10.9.8.
Add @modesty/fluent-mcp to your MCP client configuration:
{
"mcpServers": {
"fluent-mcp": {
"command": "npx",
"args": ["-y", "@modesty/fluent-mcp"],
"env": {
"FLUENT_MCP_WORKING_DIR": "/absolute/path/to/your/fluent-project",
"SN_INSTANCE_URL": "https://your-instance.service-now.com",
"SN_AUTH_TYPE": "oauth"
}
}
}
}
Client Config Locations:
- Claude Desktop (macOS):
~/Library/Application Support/Claude/claude_desktop_config.json - Claude Code CLI:
claude mcp add fluent-mcp -- npx -y @modesty/fluent-mcp - VS Code Copilot:
.vscode/mcp.json(uses"mcp": { "servers": { ... } }instead of"mcpServers") - Cursor / Windsurf / Gemini CLI: Add under
mcpServersin your client's MCP settings file
Environment Variables
| Variable | Description | Default |
|---|---|---|
FLUENT_MCP_WORKING_DIR |
Fallback absolute path to your Fluent project | — |
SN_INSTANCE_URL |
ServiceNow instance URL for automatic auth profile lookup. A matching profile is passed per call and never made your CLI default; the server never adds, deletes or selects a profile | — |
SN_AUTH_TYPE |
oauth or basic |
oauth |
FLUENT_MCP_LOG_LEVEL |
Minimum stderr log level (debug, info, notice, warning or warn, error; case-insensitive, an unknown value falls back to info with a warning) |
info |
FLUENT_MCP_COMMAND_TIMEOUT_MS |
Operator override for CLI command timeout, in ms, digits only, at most 2147483647 (1e6, 1.5, 300000ms or a longer value are ignored) |
Per-tool |
NO_TELEMETRY |
Set to 1 to disable @servicenow/sdk CLI telemetry |
— |
SN_SDK_CREDENTIALS_DIR |
Directory of the SDK's encrypted profile store credentials.enc (SDK v4.14.0+; an empty value is treated as unset) |
~/.now-sdk |
Authentication Tip: The server only reads your auth profiles. To register an instance profile, run in a terminal:
npx @servicenow/sdk auth --add <instance-url> --type <basic|oauth> --alias <alias>auth --addmakes the new profile your CLI default; runnpx @servicenow/sdk auth --use <previous alias>afterwards to keep the old one. Since@servicenow/sdk4.14.0, profiles are stored encrypted incredentials.encwith only the key in the OS keychain. The first auth lookup migrates existing keychain profiles silently; afterwards, profiles added with an oldernow-sdkare not visible to this server. If the store cannot be decrypted,check_auth_statusreports it, and you must runnow-sdk auth --delete allin a terminal and add the profile again. Do not reset for any other store error: a file written by a newernow-sdkneeds that newer SDK, and a keyring write failure needs the OS keyring unlocked. For headless CI/CD pipelines, setSN_SDK_NODE_ENV=SN_SDK_CI_INSTALLalong withSN_SDK_INSTANCE_URLandSN_SDK_USER/SN_SDK_USER_PWDorSN_SDK_OAUTH_CLIENT_ID/SN_SDK_OAUTH_CLIENT_SECRET.
MCPB Bundle (Optional)
Run npm run bundle to build a self-contained fluent-mcp-<version>.mcpb archive with dist/, res/, and production dependencies for MCPB-compatible desktop hosts. The dependencies are resolved fresh from the public npm registry, the same way an npm install of the package resolves them; an inherited registry setting, scoped ones included, is overridden, and the bundle fails if any package in its lockfile came from elsewhere, MCPB drops *.d.ts and package-lock.json by default, so the script re-includes the SDK's declarations, which a Fluent build type-checks against, and the lockfile. After packing it unpacks the archive and fails, deleting the bundle, unless the lockfile is there and the bundled SDK can build a fixture project that has no SDK of its own.
Skills (fluent-skillset)
This repository ships standalone AI agent skills under skills/ packaged as the fluent-skillset plugin.
Skill Plugin Installation
| Agent / Tool | Installation |
|---|---|
| Claude Code | Run /plugin marketplace add modesty/fluent-mcp, then /plugin install fluent-skillset@modesty and /reload-plugins |
| GitHub Copilot | Run gh skill install modesty/fluent-mcp <skill-name> (add --scope user for ~/.copilot/skills/), then /skills reload |
| Codex | Run $skill-installer https://github.com/modesty/fluent-mcp/tree/main/skills/<skill-name>, then restart Codex |
| Cursor | Settings (Cmd+Shift+J) → Plugins → paste https://github.com/modesty/fluent-mcp.git → Add to Cursor |
| Grok | Run grok plugin marketplace add modesty/fluent-mcp and grok plugin install fluent-skillset --trust |
| Windsurf / Other Agents | Prompt the agent: Please install these skills in my user level configuration from github: https://github.com/modesty/fluent-mcp/tree/main/skills (or copy skills/* into ~/.claude/skills/ or ~/.agents/skills/) |
Available Skills & Intended Usage
| Skill | Intended Usage |
|---|---|
fluent-cli |
Fluent App Development & Live Instance Queries (No MCP Required). Guides the agent through npx @servicenow/sdk CLI workflows directly via bash: project orientation (now.config.json), progressive documentation lookup (explain --list → --peek → full topic), building/transforming metadata, and querying live ServiceNow tables (query <table> -q '<encoded-query>' -o json). Ideal for lightweight CLI environments where the MCP server is not attached. |
fluent-security-review |
ServiceNow App Security Review. Audits both Fluent (now.config.json with src/ and metadata/) and classic ServiceNow XML (update/, unload/) applications, organized by risk level (Critical (7), High (26), Medium (12), Low (1)) and backed by a deterministic scanner script (scan_security_checks.mjs). Produces a structured Markdown report with Exemplary Practices, prioritized Findings (P0–P4) with actionable fixes, and a final PASS / FAIL security review conclusion. |
fluent-general-review |
ServiceNow App General Best-Practice Review. Audits both Fluent (now.config.json) and classic ServiceNow XML (update/) applications against all 31 ServiceNow general best-practice checks across Scripting (15 checks) and Configuration (16 checks), backed by a deterministic scanner script (scan_general_checks.mjs). |
fluent-perf-review |
ServiceNow App Performance Review. Audits both Fluent (now.config.json) and classic ServiceNow XML (update/) applications against all 18 ServiceNow Performance checks across Scripting (12 checks) and Configuration (6 checks), plus general memory, CPU, and query efficiency. Backed by a deterministic scanner script (scan_perf_checks.mjs) that resolves Business Rule / transform timing across Now.include() and imported server modules, and detects dictionary type changes against a previous version (--baseline <dir>). |
fluent-domain-separation-review |
ServiceNow App Domain Separation / MSP Readiness Review. Specifically for apps that must run on domain-separated (MSP / multi-tenant) instances. Audits Fluent and classic XML apps against all 10 MSP & Domain Separation checks (msp_checks.md), backed by a deterministic scanner script (scan_msp_checks.mjs). |
Available Tools (18)
SDK Command Tools (14)
| Tool | Description | Key Parameters |
|---|---|---|
sdk_info |
Get SDK version (-v) or command help (-h) |
flag, command |
explain_fluent_api |
Look up Fluent SDK docs for any API class, guide, or tag (no project required) | topic, list, peek, format (pretty|raw), debug |
init_fluent_app |
Initialize a new Fluent app or convert an existing app (non-interactive) | workingDirectory, intent, appName, packageName, scopeName, template, from, auth, debug |
build_fluent_app |
Build the Fluent application package | workingDirectory, sourceMap, debug |
deploy_fluent_app |
Deploy/install the built package to a ServiceNow instance | workingDirectory, auth, skipFlowActivation, async, debug |
fluent_transform |
Transform local XML or instance records into Fluent .now.ts source code |
workingDirectory, from, directory, table, id, force, format, timeoutSeconds, auth, debug |
download_fluent_dependencies |
Download application dependencies and script/table type definitions | workingDirectory, auth, debug |
download_fluent_app |
Download application metadata from an instance | workingDirectory, directory, source, incremental, timeoutSeconds, auth, debug |
clean_fluent_app |
Clean build output directory | workingDirectory, source, debug |
pack_fluent_app |
Zip built application into an installable artifact | workingDirectory, source, debug |
query_fluent_records |
Read-only Table REST query against an instance (returns JSON envelope); needs no Fluent project | table, query, fields, limit, offset, displayValue, select, timeout, auth |
cicd_fluent_app |
Install, publish, or rollback an app via the sn_cicd API |
workingDirectory, action (install|publish|rollback), scope|appSysId, appVersion, wait, pollTimeout, output, select |
cicd_fluent_test |
Run, watch, or fetch results/logs for ATF test suites and tests via sn_cicd |
target (testsuite|test), action (run|watch|result|logs), testSuiteSysId|testSuiteName, testSysId|testName, progressId, resultId, pattern, limit, wait, output, select |
fluent_exec_script |
Run a server-side script on the instance like Scripts - Background (now-sdk exec; admin role, destructive — approve every run; a timeout does not stop the script) |
script|file (a .js file inside the project, ≤ 64 KB; run from a private copy and echoed with its SHA-256), workingDirectory, scope, reason, timeoutMs, serverLogs, select, auth |
Knowledge & Authentication Tools (2)
| Tool | Description | Key Parameters |
|---|---|---|
get_fluent_knowledge |
Get the Fluent API specification (spec), authoring rules and pitfalls (instruct), or a runnable code snippet (snippet) for a metadata type; omit metadataType to list the types that have that kind |
kind (spec|instruct|snippet), metadataType (optional, one of the 76 types), snippetId (optional, snippets only) |
check_auth_status |
Validate and return the current ServiceNow instance authentication status | None |
Resources & Prompts
| Type | URI / Name | Purpose |
|---|---|---|
| API Specs | sn-spec://{metadataType} |
TypeScript API signatures and field schemas |
| Instructions | sn-instruct://{metadataType} |
Best practices, constraints, and common pitfalls |
| Code Snippets | sn-snippet://{metadataType}/{id} |
Practical, build-validated code examples |
| Prompts | coding_in_fluent, create_custom_ui |
End-to-end authoring and custom UI guides |
Supported Metadata Types (76)
- Core (26):
acl,application-menu,business-rule,client-script,cross-scope-privilege,data-policy,field-style,form,import-set,instance-scan,interceptor,list,property,role,scheduled-script,script-action,script-include,scripted-rest,sla,state-model,table,ui-action,ui-macro,ui-page,ui-policy,user-preference - Table & View (3):
column,column-generic,database-view - Service Catalog (6):
catalog-item,catalog-item-record-producer,catalog-ui-policy,catalog-client-script,catalog-variable,variable-set - Email (2):
email-notification,inbound-email-action - Automation & Workflow (3):
flow,custom-action,playbook - Integration & Connections (6):
alias,alias-template,retry-policy,rest-message,data-lookup,graphql-api - AI & Now Assist (3):
ai-agent,ai-agent-workflow,now-assist-skill-config - Service Portal (3):
service-portal,sp-header-footer,sp-page-route-map - Workspace & Analytics (2):
workspace,dashboard - Assessments (2):
assessment,risk-assessment - ATF & Testing (20):
atf,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-form-sp,atf-list,atf-reporting,atf-rest-api,atf-rest-assert-payload,atf-server,atf-server-catalog-item,atf-server-record,atf-ui-test-script,test-suite
Development
npm ci # Install dependencies
npm run build # Build production bundle to dist/
npm run dev # Build development bundle and start server
npm test # Run full test suite (node:test)
npm run lint # Lint TypeScript sources
npm run typecheck # Type-check src/ and test/ (npm run typecheck:test)
npm run validate:specs # Validate res/spec/*.md against SDK types
npm run validate:instructs # Validate res/instruct/*.md against SDK explain corpus
npm run validate:snippets # Compile all res/snippet/*.md via now-sdk build
npm run inspect # Launch MCP Inspector against dist/index.js
npm run bundle # Package self-contained .mcpb bundle
License
MIT
Fluent MCP questions
How do I add Fluent MCP to Claude Code?
Run claude mcp add fluent-mcp -- npx -y @modesty/fluent-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Fluent MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Fluent MCP provide?
It exposes 16 tools, including build_fluent_app, check_auth_status, cicd_fluent_app, cicd_fluent_test, clean_fluent_app.
How do I set up the Fluent MCP server?
Add @modesty/fluent-mcp to your MCP client configuration using npx, ensuring you provide the required environment variables like SN_INSTANCE_URL.
What AI agent skills are available?
The suite includes skills for CLI workflows, security reviews, general best-practice reviews, performance reviews, and domain separation/MSP readiness reviews.
Can I use this for headless CI/CD pipelines?
Yes, you can set SN_SDK_NODE_ENV=SN_SDK_CI_INSTALL along with necessary credentials to use it in CI/CD environments.