servicenow-mcp
This server connects AI assistants (Claude, ChatGPT, Cursor, etc.) to ServiceNow, enabling you to read, query, build, and automate any ServiceNow instance using natural language across 450+ tools.
ITSM — Incidents, Problems & Changes
Create, update, resolve, and close incidents, problems, and change requests
Schedule CAB meetings and add work notes/comments to any record
Tasks & Approvals
Get, update, complete, and list tasks
View, approve, reject approvals and create automated approval rules
CMDB & ITOM
Search and inspect Configuration Items (CIs) and their relationships
Run CMDB impact analysis and health dashboards
Trigger discovery scans, monitor events, and view service mapping
Knowledge Management
Search knowledge bases and articles by keyword
Create, update, publish, and retire knowledge articles
Service Catalog
List, search, create, and order catalog items
Add catalog variables and UI policies
Users & Groups
List, create, and update users and groups; manage group membership
Reporting & Analytics
Run aggregate/trend queries (COUNT, SUM, AVG, etc.) and access Performance Analytics
Create, update, and schedule reports; export data as structured JSON; create KPIs
Automation & Scripting
Create, update, and trigger scheduled jobs; view run history and system logs
Automated Test Framework (ATF)
List, run, and retrieve results for ATF test suites and individual tests; get failure insights
Querying & Search
Query any table with filtering, sorting, and pagination
Inspect table schemas and use natural language queries (NLQ) or updates
SLA Monitoring
Get SLA breach status and list active SLA records
Multi-Instance Management
List, switch between, and manage multiple ServiceNow instances mid-session
Enables GitHub Copilot to interact with ServiceNow instances, providing tools for development tasks such as writing business rules, deploying client scripts, managing UI Policies, and handling changesets across the ServiceNow platform.
Allows Google Gemini AI to access and automate ServiceNow operations, supporting ITSM, HRSD, CSM, and other ServiceNow modules with 400+ tools for querying, creating, updating, and managing records and workflows.
Integrates JetBrains IDEs with ServiceNow, providing developers with tools to write, deploy, test, and manage scripts, flows, widgets, and integrations directly from their development environment.
Enables Node.js-based AI agents and tools to connect to ServiceNow instances, offering comprehensive API access for automation, data management, and workflow orchestration across the ServiceNow platform.
Provides Ollama AI models with ServiceNow integration capabilities, allowing local AI models to query, create, update, and automate ServiceNow operations across all supported modules and domains.
Enables TypeScript-based AI agents and tools to interact with ServiceNow, offering full TypeScript types and comprehensive API coverage for development, automation, and management tasks across the ServiceNow ecosystem.
ServiceNow MCP Server (NowAIKit)
Connect Claude, ChatGPT, Gemini, Cursor, Copilot, or any AI, to ServiceNow.
500+ tools across ITSM, ITOM, CMDB, HRSD, CSM, Flow Designer, scripting & portal. Read, build, query and automate any instance in plain English.
New in 4.4 to 4.7: impact analysis (list_table_config / find_field_references / find_script_references) to see what depends on a table, field or script before you change it, Local Sync to pull artifacts to local files, and aggregate_report for server-side reports (count plus averages, no truncation).
🚀 Install (2 minutes)
Requires Node.js 20+.
# 1 — install
npm install -g nowaikit
# 2 — run the wizard: it detects your AI clients and writes their config for you
npx nowaikit setupRestart your AI client (Claude Desktop, Cursor, …) and start asking. Done.
Prefer a UI?
npx nowaikit webfor a local dashboard — or use NowAIKit Cloud (nothing to install).
Related MCP server: Atlassian MCP Server
🔌 Manual setup (skip the wizard)
Add this to your client's MCP config (Claude Desktop claude_desktop_config.json, Cursor ~/.cursor/mcp.json, etc.):
{
"mcpServers": {
"nowaikit": {
"command": "npx",
"args": ["-y", "nowaikit"],
"env": {
"SERVICENOW_INSTANCE_URL": "https://yourcompany.service-now.com",
"SERVICENOW_BASIC_USERNAME": "your_username",
"SERVICENOW_BASIC_PASSWORD": "your_password"
}
}
}
}OAuth, multiple instances, and per-client steps → Client setup · OAuth setup.
No instance? Grab a free Personal Developer Instance at developer.servicenow.com.
💬 Use it — just ask
"How many active P1 incidents are open right now?"
"Show me the 5 most recent changes and their risk."
"Create a business rule on the incident table that…"
"Run the ATF suite for the HR onboarding flow."
"What's the CMDB health for our prod CIs?"
"Look up GlideRecord.addEncodedQuery in the ServiceNow docs and show the syntax."
Read-only by default. Write, scripting and CMDB changes are opt-in flags — prod can't be modified by accident.
📚 Docs
Full guides & product home → nowaikit.com
🧩 Part of the NowAIKit suite
🌐 nowaikit.com — docs, guides & product home
☁️ NowAIKit Cloud — the toolkit in your browser, no install
📦
nowaikit-sdk— TypeScript ServiceNow client library🧰 NowAIKit Builder (VS Code) · NowAIKit Utils (browser extension)
⚠️ Official distribution only: install from npm (
nowaikit) or nowaikit.com. NowAIKit is never shipped as a downloadable GitHub.zip— beware copycat "download" repos.
© 2026 NowAIKit · Source available under the Elastic License 2.0
Available Tools
558 toolsadd_adhoc_approverA
Add an ad-hoc approver to an in-flight approval on a record (inserts a sysapproval_approver row). Requires WRITE_ENABLED=true
Inputs: record (required), approver (required), source_table.
add_commentA
Add a customer-visible comment to any ITSM record (requires WRITE_ENABLED=true)
Inputs: table (required), sys_id (required), comment (required).
add_roster_memberA
Add a member to an on-call roster (cmn_rota_member). Requires WRITE_ENABLED=true
Inputs: member (required), roster (required), order, fields.
add_user_to_groupA
Add a user to a group (requires WRITE_ENABLED=true)
Inputs: user_sys_id (required), group_sys_id (required).
add_work_noteA
Add an internal work note to any ITSM record (requires WRITE_ENABLED=true)
Inputs: note (required), table (required), sys_id (required).
advance_hr_caseA
Advance an HR case to its next state/stage (sn_hr_core_case). Parity with ServiceNow HRSD "HR Case Advance". Requires WRITE_ENABLED=true
Inputs: case (required), state, work_notes.
aggregate_reportARead-only
Server-side aggregate REPORT grouped by a field, in ONE query with no 1000-row truncation. Returns per-group record count PLUS averages/sums/mins/maxes of numeric or duration fields — the right tool for a periodic summary like "incident volume by category with average resolution time". Do NOT list raw records for this; use this. For task tables (incident, problem, change_request, cases, etc.) it INCLUDES average resolution time automatically even if avg_fields is omitted. Duration fields come back pre-formatted (e.g. "21 14:03:10"). Returns a stats table (markdown), the rows, a count chart Adaptive Card, and a summary. Read-only.
Inputs: table (required), group_by (required), limit, query, +5 more.
ai_kill_switchADestructiveIdempotent
AI Control Tower containment for one AI agent, agentic workflow or Now Assist skill. action=status reads its on/off state. action=contain switches it OFF right away for every user and channel (sn_aia_agent_config.active, sn_aia_usecase_config_override.active or sn_nowassist_skill_config.active = false). action=restore switches it back ON. The reason is written as a work note on its AI Control Tower asset when one exists. These records are application files: the change is captured in your current update set, and on a store-delivered agent or skill it marks the file as customized, which stays after restore (revert to the store version if upgrades must apply). AI Control Tower containment (Deactivate Agent / Reinstate on the AI asset, Brazil and later) is a UI feature with no documented REST API, so this flips the same active flags that AI Agent Studio and Now Assist Admin use. It does not revoke access in external platforms. Contain and restore REQUIRE WRITE_ENABLED=true, confirm=true and a reason.
Inputs: action (required), target (required), reason, confirm, +1 more.
ai_searchBRead-only
Semantic AI-powered search across KB, catalog, incidents (ServiceNow AI Search)
Inputs: query (required), limit, sources, search_app.
analyze_data_qualityBRead-only
Analyse data quality for a table — completeness, duplicates, stale records
Inputs: table (required), async, days_stale, required_fields.
approve_requestA
Approve a pending approval request (requires WRITE_ENABLED=true)
Inputs: sys_id (required), comments.
ask_ottoA
Send a plain-language request to Otto and return the answer. Two routes: (1) a2a, which sends it over A2A to an AI agent on the instance: the agent argument, else NOWAIKIT_OTTO_AGENT, else the A2A-exposed agent that looks like an orchestrator or assistant. This needs an OAuth (JWT) sign-in with the a2aauthscope scope and synchronous external agent mode. (2) moveworks, the Moveworks Conversations API (EmployeeWorks assistant), used when MOVEWORKS_API_BASE, MOVEWORKS_API_TOKEN (a user bearer from /oauth/v1/token) and MOVEWORKS_ASSISTANT_NAME are set. The moveworks route is a configured route, not verified against a live tenant. route=auto picks a2a when an agent is named or NOWAIKIT_OTTO_AGENT is set, else moveworks when configured, else a2a. Agents act with their own tools, so this REQUIRES WRITE_ENABLED=true.
Inputs: message (required), agent, route, task_id, +3 more.
assign_user_criteriaA
Attach a user criteria to a catalog item as available-for (sc_cat_item_user_criteria_mtom). Requires WRITE_ENABLED=true
Inputs: catalog_item (required), user_criteria (required).
attach_agent_toolB
Attach an existing tool (sn_aia_tool) to an Otto / Now Assist AI agent by creating a sn_aia_agent_tool_m2m link. Returns the existing link if one already exists. Requires WRITE_ENABLED=true.
Inputs: tool_sys_id (required), agent_sys_id (required), name, active, +5 more.
batch_requestCRead-only
Execute multiple ServiceNow REST API operations in a single HTTP call. Reduces round-trips by 50-70%. Each operation specifies method, URL path, and optional body. Max 50 operations per batch.
Inputs: operations (required), async.
bulk_create_recordsA
Create many records in one table in a single call, tracking every created sys_id and returning a rollback_token. With rollback_on_error=true, a mid-way failure deletes everything already created so the batch is all-or-nothing. Supports dry_run. Requires WRITE_ENABLED=true.
Inputs: table (required), records (required), async, dry_run, +1 more.
bulk_get_propertiesB
Retrieve multiple system property values in a single call
Inputs: names (required).
bulk_set_propertiesA
Create or update multiple system properties in a single operation. [Write]
Inputs: properties (required).
cancel_jobAIdempotent
Cancel a running background job. NowAIKit stops waiting at once and, where ServiceNow has a cancel API (ATF suite runs through CI/CD, flows), asks the instance to stop too. Work ServiceNow has already done is not rolled back.
Inputs: job_id (required).
categorize_incidentARead-only
Suggest category, assignment group, and priority for an incident by analysing similar resolved incidents (Table API). Predictive Intelligence has no public REST prediction endpoint; for model-based scoring run PI on-record and read the predicted field.
Inputs: short_description (required), description.
change_readinessARead-only
One-call change readiness check. Returns the change request, its conflict status, approval state, affected CIs, and other active changes that overlap the same CI. Read-only.
Inputs: number_or_sysid (required).
check_hr_eligibilityARead-only
Check an employee's eligibility for an HR service/policy via the Policy Based HR Case Evaluator skill when available, else return the employee + service context. Parity with ServiceNow HRSD "HR Eligibility Check"
Inputs: user (required), hr_service (required).
check_table_completenessBRead-only
Analyze data quality and field completeness for a ServiceNow table — returns percentage of non-empty values per field
Inputs: table (required), fields (required), async, query, +1 more.
clone_artifactA
Clone a platform artifact to a new name/scope. [Scripting]
Inputs: table (required), sys_id (required), new_name (required), target_scope.
close_change_requestADestructive
Close a change request with close code and notes (requires WRITE_ENABLED=true)
Inputs: sys_id (required), close_code (required), close_notes (required).
close_csm_caseADestructive
Close a CSM case with resolution details (requires WRITE_ENABLED=true)
Inputs: sys_id (required), resolution_notes (required), resolution_code.
close_hr_caseADestructive
Close an HR case with resolution notes (requires WRITE_ENABLED=true)
Inputs: sys_id (required), close_notes (required), close_code.
close_incidentADestructive
Close a resolved incident (requires WRITE_ENABLED=true)
Inputs: sys_id (required).
cmdb_find_duplicatesBRead-only
Find duplicate CIs by matching on specified fields (in-memory grouping)
Inputs: async, limit, ci_class, match_fields.
cmdb_find_orphansCRead-only
Find CIs with no relationships in cmdb_rel_ci
Inputs: async, limit, ci_class.
cmdb_find_staleARead-only
Find CIs not updated within a given number of days that are still operational
Inputs: async, limit, ci_class, days_threshold.
cmdb_find_unmapped_cisARead-only
Find operational CIs that have relationships but belong to no application service (mapping gaps). Parity with ServiceNow get_unmapped_topology
Inputs: limit, ci_class.
cmdb_health_dashboardBRead-only
Get CMDB data quality metrics (completeness of server and network CI data)
Inputs: async.
cmdb_impact_analysisBRead-only
Analyze the impact of a Configuration Item change or outage: what depends on it (affected if it fails) and what it depends on
Inputs: ci_sys_id (required), async, depth, direction.
cmdb_reconcileB
Act on duplicate, stale, or orphan CIs — merge, retire, or remove (requires CMDB_WRITE_ENABLED). Supports dry_run mode.
Inputs: action (required), targets (required), async, dry_run.
cmdb_services_for_ciBRead-only
Reverse lookup: which application services contain a given CI/server (svc_ci_assoc). Parity with ServiceNow get_all_application_services_for_a_server
Inputs: ci, limit, ci_name.
commit_changesetC
Commit an update set (requires SCRIPTING_ENABLED=true)
Inputs: sys_id (required).
compare_instancesARead-only
Compare two configured ServiceNow instances: record counts for a table (with optional query) and/or a specific system property value. Useful for dev→prod drift detection and governance.
Inputs: instance_a (required), instance_b (required), async, query, +2 more.
compare_record_countsBRead-only
Compare record counts across multiple ServiceNow tables or time periods — useful for capacity planning
Inputs: tables (required), query.
complete_catalog_taskA
Close a catalog fulfillment task (sc_task) as complete. Requires WRITE_ENABLED=true
Inputs: sys_id (required), state, close_notes.
complete_taskA
Mark a task as complete (requires WRITE_ENABLED=true)
Inputs: sys_id (required), state, close_notes.
complete_update_setA
Mark an Update Set as complete (ready for migration). [Scripting]
Inputs: sys_id (required).
configure_offline_syncAIdempotent
Configure which records of a table are available offline in mobile: sets the data item offline query condition, and optionally marks a screen available offline and enables offline on an app config. [Write]
Inputs: table (required), query, screen, data_item, +2 more.
configure_workspace_listCIdempotent
Add or update a list view in an agent workspace. [Write]
Inputs: table (required), title (required), workspace_sys_id (required), order, +3 more.
copy_attachmentA
Copy an existing ServiceNow attachment onto another record, entirely server-side (requires WRITE_ENABLED=true). The file bytes never pass through this tool call. Ideal for "attach the same document from this record onto that KB / incident".
Inputs: target_table (required), attachment_sys_id (required), target_record_sys_id (required), file_name.
create_aclA
Create a new ACL rule to control access to a table or field (requires SCRIPTING_ENABLED=true)
Inputs: name (required), operation (required), type, roles, +4 more.
create_agentic_workflowB
Create an agentic workflow linked to an AI agent (requires NOW_ASSIST_ENABLED + WRITE_ENABLED)
Inputs: name (required), steps (required), description (required), agent_sys_id (required), +2 more.
create_ai_agentA
Create an AI agent definition with optional auto-generated ACLs (requires NOW_ASSIST_ENABLED + WRITE_ENABLED)
Inputs: name (required), description (required), capabilities (required), role, +2 more.
create_approval_ruleA
Create an approval rule that automatically generates approval requests when a record matches given conditions (requires WRITE_ENABLED=true). Uses the Approval Rules table (sysrule_approvals).
Inputs: name (required), table (required), approver (required), approver_type (required), +3 more.
create_assetB
Create a new IT asset record. [Write]
Inputs: display_name (required), cost, model, location, +6 more.
create_business_ruleA
Create a new business rule (requires SCRIPTING_ENABLED=true). ServiceNow supports ES2021 async/await in scripts.
Inputs: name (required), when (required), table (required), script (required), +3 more.
create_business_serviceC
Create a business service (cmdb_ci_service). Requires WRITE_ENABLED=true
Inputs: name (required), fields, owned_by, support_group.
create_catalog_categoryA
Create a catalog category (sc_category). Requires WRITE_ENABLED=true
Inputs: title (required), fields, parent, catalog, +1 more.
create_catalog_itemA
Create a new service catalog item (requires WRITE_ENABLED=true)
Inputs: name (required), short_description (required), price, roles, +4 more.
create_catalog_ui_policyA
[Write] Create a UI policy for a catalog item form
Inputs: cat_item_id (required), short_description (required), conditions, reverse_if_false.
create_catalog_variableC
[Write] Add a form variable to a service catalog item
Inputs: name (required), type (required), cat_item_id (required), question_text (required), +2 more.
create_change_requestA
Create a new change request (requires WRITE_ENABLED=true)
Inputs: type (required), short_description (required), risk, impact, +11 more.
create_ci_relationshipA
[Write] Create a relationship between two CMDB Configuration Items
Inputs: type (required), child (required), parent (required).
create_client_scriptA
Create a new client script (onLoad, onChange, onSubmit, onCellEdit) (requires SCRIPTING_ENABLED=true)
Inputs: name (required), type (required), table (required), script (required), +3 more.
create_csm_caseA
Create a new Customer Service case (requires WRITE_ENABLED=true)
Inputs: short_description (required), account, contact, product, +5 more.
create_dashboardB
Create a new Performance Analytics dashboard (requires WRITE_ENABLED=true)
Inputs: name (required), owner, roles, active, +1 more.
create_decision_inputA
Add an input to a decision table (sys_decision_input). Requires WRITE_ENABLED=true
Inputs: name (required), decision_sys_id (required), type, order, +1 more.
create_decision_tableA
Create a Decision Builder decision table (sys_decision). Requires WRITE_ENABLED=true
Inputs: name (required), active, fields, description, +1 more.
create_delegationA
Create an approval/coverage delegation (sys_user_delegate). Requires WRITE_ENABLED=true
Inputs: user (required), delegate (required), ends, starts, +2 more.
create_demandA
Create an SPM demand (dmn_demand). Requires WRITE_ENABLED=true.
Inputs: short_description (required), fields, description.
create_devops_changeA
Create a change request linked to a DevOps deployment for change governance. [Write]
Inputs: environment (required), short_description (required), type, artifact, +3 more.
create_epicA
Create a new epic (requires WRITE_ENABLED=true)
Inputs: short_description (required), project, description.
create_flowB
Create a new Flow Designer flow. [Write]
Inputs: name (required), scope, description, trigger_type, +1 more.
create_flow_actionA
Create a custom Flow Designer action. [Scripting]
Inputs: name (required), inputs, script, outputs, +1 more.
create_grc_controlB
Author a compliance control (sn_compliance_control). Requires WRITE_ENABLED=true
Inputs: name (required), fields, profile, description.
create_grc_issueA
Raise a GRC issue/finding (sn_grc_issue). Requires WRITE_ENABLED=true
Inputs: short_description (required), fields, source, description.
create_grc_riskA
Create a new GRC risk entry. [Write]
Inputs: name (required), category (required), owner, impact, +2 more.
create_groupA
Create a new assignment group (requires WRITE_ENABLED=true)
Inputs: name (required), manager, description.
create_hr_caseA
Create a new HR Service Delivery case (requires WRITE_ENABLED=true)
Inputs: hr_service (required), short_description (required), priority, description, +2 more.
create_hr_taskA
Create a task within an HR case (requires WRITE_ENABLED=true)
Inputs: hr_case_sysid (required), short_description (required), due_date, assigned_to.
create_import_set_rowA
Insert a row into an Import Set staging table for later transformation (requires WRITE_ENABLED=true)
Inputs: data (required), staging_table (required).
create_incidentA
Create a new incident record (requires WRITE_ENABLED=true)
Inputs: short_description (required), impact, urgency, category, +5 more.
create_knowledge_articleB
Create a new knowledge article (requires WRITE_ENABLED=true)
Inputs: text (required), short_description (required), knowledge_base_sys_id (required), category.
create_kpiC
[Write] Create a Key Performance Indicator from ServiceNow data
Inputs: name (required), table (required), aggregate (required), unit, +2 more.
create_mobile_app_configB
Create a new mobile app configuration. [Write]
Inputs: name (required), type, navigation, description, +1 more.
create_mobile_appletC
Create a mobile applet in a mobile app. [Write]
Inputs: name (required), table (required), icon, query, +2 more.
create_mobile_layoutC
Create a mobile layout for a specific view. [Write]
Inputs: name (required), table (required), type, template, +1 more.
create_notificationA
Create a new email notification definition (requires WRITE_ENABLED=true)
Inputs: name (required), table (required), event, active, +4 more.
create_now_assist_skillA
Create a draft Now Assist skill: a OneExtend capability (type skill, holding the input/output schema and prompt template in its metadata) plus its sn_nowassist_skill_config registration. Finish the prompt/provider in Now Assist Skill Kit before activating (requires NOW_ASSIST_ENABLED + WRITE_ENABLED)
Inputs: name (required), description (required), input_schema (required), output_schema (required), +4 more.
create_offboarding_caseB
Create an employee offboarding case with exit tasks. [Write]
Inputs: last_day (required), employee_sys_id (required), reason, manager, +1 more.
create_onboarding_caseB
Create an employee onboarding case with all standard tasks. [Write]
Inputs: start_date (required), employee_sys_id (required), manager, location, +3 more.
create_on_call_overrideA
Create an on-call coverage override for a date range (a roster schedule entry, roster_schedule_span). Requires WRITE_ENABLED=true
Inputs: end (required), start (required), member (required), roster (required), +2 more.
create_pa_breakdownA
Create a Performance Analytics (PA) breakdown on pa_breakdowns (requires WRITE_ENABLED=true). Breakdowns slice an indicator by a dimension (e.g. by Assignment group or Category).
Inputs: name (required), active, description, related_field, +1 more.
create_pa_indicatorA
Create a Performance Analytics (PA) indicator / KPI on pa_indicators (requires WRITE_ENABLED=true). Define the source facts table, aggregation and conditions; collect data via a PA job afterward.
Inputs: name (required), unit, field, active, +6 more.
create_playbookA
Create (or update) a NowAIKit playbook definition with ordered steps that chain tool calls, stored as system property nowaikit.playbook.; run it with execute_playbook (requires NOW_ASSIST_ENABLED + WRITE_ENABLED)
Inputs: name (required), steps (required), description (required).
create_portalA
Create a new Service Portal configuration (requires WRITE_ENABLED=true)
Inputs: title (required), url_suffix (required), logo, theme, +2 more.
create_portal_pageA
Create a new page inside a Service Portal (requires WRITE_ENABLED=true)
Inputs: id (required), title (required), portal_sys_id (required), description.
create_portal_widgetA
Create a new Service Portal widget with template, CSS, and scripts (requires WRITE_ENABLED=true)
Inputs: id (required), name (required), css, template, +4 more.
create_problemA
Create a new problem record (requires WRITE_ENABLED=true)
Inputs: short_description (required), priority, description, assignment_group.
create_projectA
Create a SPM project (pm_project). Requires WRITE_ENABLED=true.
Inputs: short_description (required), state, fields, priority, +1 more.
create_recordA
Create a new record in any ServiceNow table (requires WRITE_ENABLED=true). Pass dry_run=true to preview the resolved payload without writing.
Inputs: table (required), fields (required), dry_run.
create_reportA
Create a new saved report on any table (requires WRITE_ENABLED=true)
Inputs: type (required), table (required), title (required), field, +4 more.
create_rest_messageA
Create a new outbound REST Message definition (requires WRITE_ENABLED=true)
Inputs: name (required), endpoint (required), description, use_mutual_auth, +1 more.
create_roleA
Create a new role (sys_user_role). Requires WRITE_ENABLED=true
Inputs: name (required), fields, description.
create_rota_scheduleB
Create an on-call rotation (cmn_rota) for a group. Requires WRITE_ENABLED=true
Inputs: name (required), group (required), fields, time_zone.
create_scheduled_jobA
Create a new scheduled script execution job (requires WRITE_ENABLED=true)
Inputs: name (required), script (required), run_type (required), active, +2 more.
create_scheduled_reportC
[Write] Schedule a report for recurring email delivery (sysauto_report)
Inputs: frequency (required), report_id (required), recipients (required), name, +5 more.
create_scoped_appA
Create a new scoped application in App Studio (requires WRITE_ENABLED=true). The scope follows x__, where is the instance's REGISTERED vendor prefix (glide.appcreator.company.code), not an arbitrary value. Leave scope blank to auto-derive it from the instance vendor prefix + app name; if you pass a scope whose vendor segment differs from the instance prefix, it is corrected to the registered one.
Inputs: name (required), logo, scope, active, +4 more.
create_script_includeA
Create a new script include (requires SCRIPTING_ENABLED=true)
Inputs: name (required), script (required), scope, access, +3 more.
create_scrum_taskA
Create a scrum task (sub-task of a story) (requires WRITE_ENABLED=true)
Inputs: short_description (required), assigned_to, story_sys_id.
create_security_incidentB
Create a Security Operations incident (requires WRITE_ENABLED=true)
Inputs: category (required), short_description (required), severity, description, +3 more.
create_service_offeringA
Create a service offering under a business service (service_offering). Requires WRITE_ENABLED=true
Inputs: name (required), fields, parent, support_group.
create_sla_definitionA
Create an SLA/OLA definition (contract_sla). Requires WRITE_ENABLED=true
Inputs: name (required), collection (required), type, fields, +5 more.
create_solution_packageB
Create a solution package from selected update sets for distribution. [Write]
Inputs: name (required), update_sets (required), description.
create_storyA
Create a new agile story/user story (requires WRITE_ENABLED=true)
Inputs: short_description (required), epic, sprint, assigned_to, +2 more.
create_story_dependencyA
Link one agile story as dependent on another (m2m_story_dependencies). Requires WRITE_ENABLED=true.
Inputs: story (required), dependent_story (required).
create_subflowB
Create a new reusable subflow. [Write]
Inputs: name (required), scope, inputs, description.
create_surveyA
Create a survey/assessment definition (asmt_metric_type). Requires WRITE_ENABLED=true
Inputs: name (required), type, fields, description.
create_ui_actionA
Create a new UI Action (button or link) on a form (requires SCRIPTING_ENABLED=true)
Inputs: name (required), table (required), action_name (required), type, +5 more.
create_uib_componentC
Create a custom UI Builder component (macroponent). [Scripting]
Inputs: name (required), label (required), category, description.
create_uib_data_brokerA
Create a UI Builder transform data broker (server script) that returns records from a table. Add it to a page in UI Builder; it needs a ux_data_broker execute ACL. [Scripting]
Inputs: name (required), table (required), page, query, +1 more.
create_uib_pageA
Create a new UI Builder page: a screen collection (sys_ux_screen_type) plus, when app is given, its route (sys_ux_app_route). Build the page content in UI Builder. [Write]
Inputs: path (required), title (required), app, layout.
create_ui_policyA
Create a new UI Policy to control field behavior dynamically (requires SCRIPTING_ENABLED=true)
Inputs: table (required), short_description (required), active, script, +2 more.
create_update_setA
Create a new Update Set and optionally switch to it. [Scripting]
Inputs: name (required), release, switch_to, description.
create_userA
Create a new user account (requires WRITE_ENABLED=true)
Inputs: email (required), last_name (required), user_name (required), first_name (required), +2 more.
create_user_criteriaB
Create a user criteria record (user_criteria) for catalog entitlement/audience. Requires WRITE_ENABLED=true
Inputs: name (required), roles, users, fields, +2 more.
create_ux_app_routeC
Register a new route (URL path) in a UX app. [Write]
Inputs: path (required), app_sys_id (required), page_sys_id (required), title.
create_ux_experienceC
Create a new UX Experience (app shell) configuration. [Write]
Inputs: name (required), app_sys_id (required), path, landing_page.
create_va_topicC
Create a new Virtual Agent conversation topic. [Write]
Inputs: name (required), active, category, description, +1 more.
create_workspaceB
Create a new configurable workspace config (sys_aw_master_config) with a default list for its primary table. The UI Builder experience itself is generated in Workspace Builder. [Write]
Inputs: name (required), table (required), url, icon, +3 more.
deactivate_userADestructive
Deactivate (offboard) a user by setting active=false. Requires WRITE_ENABLED=true
Inputs: user (required).
delete_attachmentADestructive
Delete an attachment from a record (requires WRITE_ENABLED=true)
Inputs: attachment_sys_id (required).
delete_recordADestructive
Delete a record from any ServiceNow table (requires WRITE_ENABLED=true). Pass dry_run=true to preview the record that would be deleted without deleting it.
Inputs: table (required), sys_id (required), dry_run.
delete_story_dependencyADestructive
Remove a story dependency link by its m2m_story_dependencies sys_id. Requires WRITE_ENABLED=true.
Inputs: sys_id (required).
delete_system_propertyADestructive
Delete a system property by name. [Write]
Inputs: name (required).
delete_uib_pageBDestructive
Delete a UI Builder page (screen collection) with its routes and screen variants. [Write]
Inputs: sys_id (required).
describe_kg_schemaARead-only
Describe one Knowledge Graph schema (sys_meta_graph) used by Otto / Now Assist: its nodes (tables, labels, properties) and edges (relationships). Reads sys_meta_graph_node / sys_meta_graph_edge, falling back to the graph schema_json.
Inputs: graph (required), include_properties.
detach_agent_toolADestructive
Detach a tool from an Otto / Now Assist AI agent: deletes the sn_aia_agent_tool_m2m link (or only deactivates it with deactivate_only). Identify the link by link_sys_id, or by agent_sys_id + tool_sys_id. The tool itself is not deleted. Requires WRITE_ENABLED=true.
Inputs: link_sys_id, tool_sys_id, agent_sys_id, deactivate_only.
discover_tableARead-only
Discover a ServiceNow table schema and register dynamic CRUD tools for it. After discovery, new tools become available: dynamic_query_, dynamic_get_, dynamic_create_, dynamic_update_, dynamic_delete_. Schemas are cached for 30 minutes.
Inputs: table (required), operations.
ensure_active_update_setAIdempotent
Ensure an active Update Set exists; create one automatically if none is in progress. [Scripting]
Inputs: default_name.
execute_background_scriptBDestructive
Execute a background script on the instance (server-side JavaScript). [Scripting]
Inputs: script (required), scope.
execute_playbookB
Execute a playbook step by step, passing results forward through context (requires NOW_ASSIST_ENABLED). Supports dry_run.
Inputs: playbook (required), async, context, dry_run.
execute_scriptADestructive
Execute a server-side script on the ServiceNow instance (Background Script). Supports GlideRecord, GlideQuery, GlideAggregate, and all server-side APIs. Returns the script output. Use for complex queries that cannot be expressed via REST. REQUIRES WRITE_ENABLED=true.
Inputs: script (required), scope.
export_propertiesARead-only
Export system properties matching a query to a JSON object (useful for environment snapshots)
Inputs: query, category.
export_report_dataCRead-only
Export raw table data as structured JSON for use in external reports
Inputs: table (required), async, limit, query, +1 more.
export_update_setB
Get the XML export payload for an Update Set (as used in migration). [Scripting]
Inputs: sys_id (required), async.
fetch_servicenow_docARead-only
Fetch the full readable text of a specific ServiceNow documentation page. Pass either the ref returned by search_servicenow_docs (fastest, exact) or a servicenow.com/docs page URL. Use after search_servicenow_docs to read a result in full. Read-only; only ServiceNow docs are reachable.
Inputs: ref, url, maxChars.
find_artifactCRead-only
Search for platform artifacts by name, type, or scope (business rules, scripts, widgets, etc.)
Inputs: name (required), type, limit, scope.
find_field_referencesARead-only
Find where a table field is used — its dictionary entry plus any scripts (business rules, script includes, client scripts, UI actions, widgets) that mention the field name. Use it before renaming or removing a field. Script matches are substring (LIKE) hits, so expect false positives (comments, similarly-named symbols) and misses for dynamically-built references; treat results as candidates to review, not a definitive list.
Inputs: field (required), table (required), limit.
find_property_usageARead-only
Find scripts that read a system property (sys_properties) by name, plus the property record itself. Use it before changing or removing a property. Matches are substring (LIKE) hits — candidates to review, not definitive.
Inputs: name (required), limit.
find_script_referencesARead-only
Find what references a Script Include or named artifact — scans script-bearing config tables for textual use of the name. Use it before renaming or deleting a Script Include, Script Action, etc. Matches are substring (LIKE) hits, so treat them as candidates to review (false positives from comments/similar names; misses for dynamic references).
Inputs: name (required), limit.
find_update_setsARead-only
List the update sets that contain changes to an artifact (by name), so you know what is in-flight or already captured for promotion before you touch it.
Inputs: name (required), limit.
fire_eventA
Fire a custom ServiceNow event for a specific record (requires WRITE_ENABLED=true)
Inputs: table (required), event_name (required), record_sys_id (required), parm1, +1 more.
fluent_buildA
Compile a Fluent (now-sdk) project into installable app files. Runs now-sdk build. Set frozen_keys=true in CI to fail when keys/sys_ids are out of date. REQUIRES FLUENT_ENABLED=true and WRITE_ENABLED=true.
Inputs: async, directory, source_map, frozen_keys, +1 more.
fluent_cicdB
Run ServiceNow CI/CD operations via the SDK (now-sdk cicd): install an app version from the app repository, publish an app to it, roll an app back, or run an ATF test or test suite (optionally on the ATF Cloud Runner). REQUIRES FLUENT_ENABLED=true and WRITE_ENABLED=true.
Inputs: action (required), auth, async, scope, +9 more.
fluent_dependenciesA
Download the dependencies declared in now.config.json plus TypeScript type definitions (Script Include types, glide.*.d.ts, ChoiceSets). Use add + scope to register new dependency records. Runs now-sdk dependencies. REQUIRES FLUENT_ENABLED=true and WRITE_ENABLED=true (writes local files).
Inputs: add, auth, async, scope, +4 more.
fluent_downloadA
Download an application's metadata from the instance into a local folder (now-sdk download). Uses the SDK's default credential (the download command has no alias flag; switch with now-sdk auth --use <alias>). REQUIRES FLUENT_ENABLED=true and WRITE_ENABLED=true (writes local files).
Inputs: target (required), async, directory, incremental.
fluent_execA
Run a server-side script on the instance through the SDK (now-sdk exec, 4.14+). Unlike a plain background script, the run is recorded on a Script Execution History record with your reason, and record changes can be rolled back from there. REQUIRES FLUENT_ENABLED=true and SCRIPTING_ENABLED=true.
Inputs: reason (required), script (required), auth, async, +4 more.
fluent_explainARead-only
Live ServiceNow SDK documentation from now-sdk explain: current Fluent API signatures, guides and examples (about 300 topics), not training-data guesses. Fuzzy search is supported, so a keyword like "catalog variable" works. Use list=true to list topics, peek=true for a short summary. Known topics include: GlideQuery, table API, scoped app, now.config.json, keys.ts, metadata, Table, Record, List, ChoiceSet, Property, Role, Acl, CrossScopePrivilege, ApplicationMenu, Now.del, Now.attach, DataLookup, DatabaseView, BusinessRule, ClientScript, ScriptInclude, ScriptAction, UiAction, UiPolicy, UiPage, UiMacro, DataPolicy, Form, StateModel, override, CatalogItem, CatalogItemRecordProducer, VariableSet, CatalogClientScript, CatalogUiPolicy, UserCriteria, RestApi, GraphQLApi, RestMessage, Alias, AliasTemplate, RetryPolicy, ImportSet, InboundEmailAction, Flow, Subflow, Action, CustomAction, TryCatch, DoInParallel, FlowStages, Playbook, ScheduledScript, Sla, EmailNotification, AiAgent, AiAgenticWorkflow, roleMap, NowAssistSkillConfig, ServicePortal, SPWidget, SPPage, SPTheme, SPMenu, SPHeaderFooter, Workspace, Dashboard, Test, TestSuite, InstanceScan, Assessment, RiskAssessment, cicd.
Inputs: list, peek, range, topic.
fluent_initA
Create a new Fluent (now-sdk) application, apply a template to an existing one, or convert a legacy scoped app into Fluent source (from = app sys_id on the instance, or a local folder). Runs now-sdk init in the given directory. REQUIRES FLUENT_ENABLED=true and WRITE_ENABLED=true.
Inputs: auth, from, name, scope, +4 more.
fluent_installA
Install or update a built Fluent app on the instance (now-sdk install). info=true only reports the most recent install. reinstall=true uninstalls first and DISCARDS on-instance metadata not present locally. REQUIRES FLUENT_ENABLED=true and WRITE_ENABLED=true.
Inputs: auth, info, async, demo_data, +3 more.
fluent_packARead-only
Zip a built Fluent app into an installable artifact (now-sdk pack). REQUIRES FLUENT_ENABLED=true.
Inputs: async, directory, skip_package_inventory.
fluent_queryARead-only
GlideQuery-style fluent query builder. Supports select, where, aggregate (COUNT/AVG/SUM/MIN/MAX), orderBy, limit, and groupBy. Returns records or aggregate results. Example: { table: "incident", where: [["active","=",true],["priority","<",3]], select: ["number","short_description"], limit: 10 }
Inputs: table (required), limit, where, select, +6 more.
fluent_sdk_queryARead-only
Run now-sdk query <table>: a read-only Table API query through the ServiceNow SDK CLI using its saved credentials (no browser). Ideal while authoring Fluent code: resolve sys_ids, inspect schemas, check existing records, read choice values. Example: { table: "sys_user_role", query: "name=admin", fields: ["sys_id","name"], limit: 1 }
Inputs: table (required), auth, limit, query, +3 more.
fluent_transformA
Convert XML records from the instance (by table) or from local XML files into Fluent source code (now-sdk transform). REQUIRES FLUENT_ENABLED=true and WRITE_ENABLED=true (writes local files).
Inputs: auth, from, async, force, +2 more.
fluent_validateARead-only
Check that a Fluent (now-sdk) project compiles cleanly without installing it: runs now-sdk build --frozenKeys --errorOnConflict, so type errors, unknown properties, stale keys and sys_id conflicts all fail. REQUIRES FLUENT_ENABLED=true.
Inputs: directory.
fluent_versionARead-only
Report the installed @servicenow/sdk (now-sdk) version and whether it meets the version NowAIKit tracks features against (currently 4.14.2). Returns an upgrade hint when out of date.
Inputs: no named parameters.
generate_case_activity_responseARead-only
Draft an agent reply for a CSM case activity stream via the Now Assist activity-response skill when available, else return the case context to draft from. Parity with ServiceNow CSM "Activity Response"
Inputs: case (required), table, instruction.
generate_csm_resolution_notesARead-only
Generate CSM resolution notes via the Now Assist resolution-notes skill when available, else return the case + work notes to summarize. Parity with ServiceNow CSM "Generate Resolution Notes"
Inputs: case (required), table.
generate_reportARead-only
Generate a branded PDF or PPTX report from capability analysis results. Call this after completing a scan, review, or audit to create a management-ready document with charts, tables, and ServiceNow links. Supports single capability (content) or multiple capabilities (sections) in one combined report.
Inputs: title (required), format (required), content, sections, +1 more.
get_aclARead-only
Get full details of an ACL rule including its script and role requirements (requires SCRIPTING_ENABLED=true)
Inputs: sys_id (required).
get_agent_execution_traceARead-only
Get an ordered timeline for one Otto / Now Assist AI agent run: the execution plan (sn_aia_execution_plan) plus its tasks (sn_aia_execution_task), conversation messages (sn_aia_message) and tool calls with request/response (sn_aia_tools_execution). Use list_ai_agent_executions to find the plan sys_id.
Inputs: execution_plan_sys_id (required), limit, include_payloads.
get_agent_versionsARead-only
Get the version history of an Otto / Now Assist AI agent or agentic workflow (sn_aia_version): version number, name, state (Draft/Published), instructions and condition. Newest first.
Inputs: target_id (required), limit, state, target_table, +1 more.
get_ai_agentARead-only
Get an AI agent definition with its config, tools, versions and execute ACLs
Inputs: sys_id (required).
get_ai_agent_executionBRead-only
Get an AI Agent execution plan with its steps/tool calls (sn_aia_execution_plan + sn_aia_execution_task)
Inputs: sys_id (required).
get_ai_assetARead-only
Get one AI Control Tower asset (alm_ai_digital_asset) with its governance details, lifecycle phase, risk, and any assessment / approval requests and tasks. Works for Otto (Now Assist) skills, AI agents, prompts, models and MCP assets.
Inputs: sys_id (required).
get_ai_usageARead-only
Report AI usage for Otto (Now Assist) and other AI: AI Control Tower inventory/billing counts (sn_ai_governance_ai_inventory_usage, daily snapshots) and Generative AI assist consumption (sys_gen_ai_usage_log), over a date range and grouped by a field.
Inputs: to, from, source, group_by.
get_approval_historyBRead-only
Get the approval progression/history for any record (sysapproval_approver rows, ordered)
Inputs: record (required), limit.
get_assetARead-only
Get full details of an IT asset including financial and lifecycle data
Inputs: sys_id (required).
get_atf_failure_insightARead-only
Get ATF Failure Insight data — metadata changes between last successful and failed run (role changes, field value changes)
Inputs: result_sys_id (required).
get_atf_suiteARead-only
Get details of a test suite including test count
Inputs: sys_id_or_name (required).
get_atf_suite_resultBRead-only
Get the results of a test suite run
Inputs: result_sys_id (required).
get_atf_testBRead-only
Get details of a specific test case
Inputs: sys_id (required).
get_attachment_metadataARead-only
Get metadata (name, type, size) of a specific attachment by its sys_id
Inputs: attachment_sys_id (required).
get_business_ruleARead-only
Get full details and script body of a business rule (requires SCRIPTING_ENABLED=true)
Inputs: sys_id (required).
get_case_sentimentARead-only
Assess customer sentiment on a CSM case via the Now Assist sentiment skill when available, else return the case + customer comments for sentiment analysis. Parity with ServiceNow CSM "Sentiment Analysis"
Inputs: case (required), table.
get_catalog_itemARead-only
Get full details of a catalog item including its variables
Inputs: sys_id_or_name (required).
get_change_requestARead-only
Get full details of a change request by number (CHG...) or sys_id
Inputs: number_or_sysid (required).
get_changesetARead-only
Get details of an update set (requires SCRIPTING_ENABLED=true)
Inputs: sys_id_or_name (required).
get_client_scriptARead-only
Get full details and script body of a client script (requires SCRIPTING_ENABLED=true)
Inputs: sys_id (required).
get_cmdb_ciBRead-only
Get complete information about a specific configuration item
Inputs: ci_sys_id (required), fields.
get_compliance_assessmentBRead-only
Get compliance assessment results for a policy or control
Inputs: policy_sys_id, control_sys_id.
get_csm_accountARead-only
Get details of a customer account including contacts and open cases count
Inputs: name_or_sysid (required).
get_csm_caseARead-only
Get full details of a CSM case by number (e.g. CS0001234) or sys_id
Inputs: number_or_sysid (required).
get_csm_case_slaARead-only
Get SLA details and remaining time for a CSM case
Inputs: case_sysid (required).
get_csm_contactARead-only
Get details of a customer contact (name, account, phone, email)
Inputs: name_or_sysid (required).
get_current_instanceARead-only
Get the currently active ServiceNow instance name and URL
Inputs: no named parameters.
get_current_update_setARead-only
Get the currently active Update Set for the session
Inputs: no named parameters.
get_decision_tableARead-only
Get a decision table with its inputs and answer rows, by name or sys_id
Inputs: name_or_sysid (required).
get_deploymentARead-only
Get details and status of a specific deployment
Inputs: sys_id (required).
get_devops_insightsARead-only
Get deployment frequency, failure rate, and lead time metrics for a pipeline
Inputs: days, pipeline_sys_id.
get_devops_pipelineARead-only
Get details of a specific DevOps pipeline
Inputs: sys_id (required).
get_ecc_queueARead-only
Inspect the ECC queue (ecc_queue) — MID server probes/sensors, by state, agent, or topic
Inputs: agent, limit, queue, state, +1 more.
get_email_logARead-only
Get full details of an email log entry including body and headers
Inputs: sys_id (required).
get_evaluation_resultsARead-only
Get the results of one Otto / Now Assist evaluation run: the run (sys_one_extend_batch_run), per-metric results with a pass/fail summary (sys_one_extend_eval_metric_result), per-record results (sys_one_extend_batch_result) and child runs.
Inputs: batch_run_sys_id (required), limit, include_records.
get_event_registry_entryARead-only
Get details of a specific registered event definition
Inputs: name_or_sysid (required).
get_flowARead-only
Get full details of a Flow Designer flow including its actions and trigger
Inputs: name_or_sysid (required).
get_flow_error_logARead-only
Get detailed error logs for failed flow executions
Inputs: flow_sys_id (required), days, limit.
get_flow_executionARead-only
Get the status and details of a specific flow execution
Inputs: execution_sysid (required).
get_grc_riskARead-only
Get details of a GRC risk including impact, likelihood, and controls
Inputs: number_or_sysid (required).
get_groupARead-only
Find assignment group details by name or sys_id
Inputs: group_identifier (required).
get_hr_caseARead-only
Get full details of an HR case by number (e.g. HRCS0001234) or sys_id
Inputs: number_or_sysid (required).
get_hr_case_activityARead-only
Get the full activity log and journal entries for an HR case
Inputs: hr_case_sysid (required).
get_hr_lifecycle_eventsARead-only
Get HR lifecycle events for an employee (promotions, transfers, leaves)
Inputs: employee_sys_id (required), limit, event_type.
get_hr_profileARead-only
Get the HR profile for a user (employment details, department, manager)
Inputs: user_identifier (required).
get_hr_serviceARead-only
Get details of a specific HR service including its tasks and SLAs
Inputs: sys_id_or_name (required).
get_import_setARead-only
Get details of a specific Import Set including row count and transform status
Inputs: sys_id (required).
get_incidentARead-only
Get full details of an incident by number (e.g. INC0012345) or sys_id
Inputs: number_or_sysid (required).
get_instance_scan_findingsARead-only
List Instance Scan findings (scan_finding) — best-practice violations, optionally by check or suite result
Inputs: async, check, limit, table, +1 more.
get_jobARead-only
Check a background job started by a long-running tool (async: true, or a call that ran past about 20 seconds). Returns status (running, completed, failed, cancelled), progress, elapsed time and, once finished, the tool result. Pass wait_seconds to wait for it to finish.
Inputs: job_id (required), wait_seconds.
get_knowledge_articleARead-only
Get the full content of a knowledge article by number (KB...) or sys_id
Inputs: number_or_sysid (required).
get_license_complianceARead-only
Get license compliance summary — purchased vs. installed vs. in use counts
Inputs: license_sys_id.
get_license_optimizationARead-only
Analyze software license usage and recommend optimizations
Inputs: software_name, threshold_pct.
get_mandatory_fieldsARead-only
List the fields that ServiceNow Data Policies make mandatory on a table (and when they apply). Call this before creating or updating a record so you can collect the required fields up front and avoid a "Data Policy Exception: the following fields are mandatory" error.
Inputs: table (required).
get_mobile_analyticsARead-only
Get mobile app usage analytics — sessions, active users, popular applets
Inputs: days.
get_mobile_app_configARead-only
Get details of a specific mobile app configuration
Inputs: sys_id (required).
get_ms_copilot_topicsARead-only
List the Virtual Agent topics (sys_cs_topic) that back a Microsoft Copilot integration. Copilot topic mapping itself is configured in Copilot Studio on the Microsoft side, not exposed via ServiceNow REST.
Inputs: limit.
get_my_approvalsARead-only
List approvals pending for the currently configured user
Inputs: state.
get_notificationARead-only
Get full details of an email notification definition including template and conditions
Inputs: sys_id_or_name (required).
get_now_assist_skillARead-only
Get a single Now Assist skill definition by sys_id (requires NOW_ASSIST_ENABLED)
Inputs: sys_id (required).
get_on_call_nowARead-only
Find who is on call for a group right now. Returns the current roster members for the group's rotations
Inputs: group (required).
get_otto_statusARead-only
One report of what AI is available on this instance: installed Otto / Now Assist, Generative AI Controller, AI Agents, MCP server/client, Knowledge Graph and AI Control Tower apps with versions (sys_scope), key properties (sn_aia.external_agents.enabled, sn_aia.enable_mcp_tool) and counts of agents, tools, triggers and deployments.
Inputs: no named parameters.
get_pa_dashboardARead-only
Get details of a PA dashboard including its widgets/tabs
Inputs: sys_id_or_name (required).
get_pa_indicatorARead-only
Get details of a specific Performance Analytics indicator including its formula
Inputs: sys_id_or_name (required).
get_pa_jobCRead-only
Get details of a Performance Analytics collection job
Inputs: sys_id (required).
get_pa_scorecardARead-only
Get current scorecard data for a PA indicator — returns current value, target, trend direction
Inputs: indicator_sys_id (required), period, include_scores, breakdown_sys_id.
get_pa_time_seriesARead-only
Get historical time-series data for a PA indicator to identify trends
Inputs: indicator_sys_id (required), limit, end_date, start_date.
get_performance_analyticsARead-only
Read Performance Analytics scorecard/indicator data (requires PA plugin; GET /api/now/pa/scorecards). Pass an indicator sys_id, or a PA widget sys_id to resolve its indicator.
Inputs: to, from, widget_sys_id, indicator_sys_id.
get_pi_modelsARead-only
List available Predictive Intelligence solutions (classification/similarity models)
Inputs: no named parameters.
get_portalARead-only
Get full configuration details of a Service Portal by sys_id or URL suffix
Inputs: id (required).
get_portal_pageARead-only
Get details of a specific Service Portal page including its layout
Inputs: sys_id (required).
get_portal_themeARead-only
Get full details of a Service Portal theme including CSS variables
Inputs: sys_id (required).
get_portal_widgetARead-only
Get full source code (HTML, CSS, client/server scripts) of a Service Portal widget
Inputs: id_or_sysid (required).
get_portfolioBRead-only
Get a portfolio (pm_portfolio) by sys_id, with the projects linked to it.
Inputs: sys_id (required).
get_problemARead-only
Get full details of a problem by number (PRB...) or sys_id
Inputs: number_or_sysid (required).
get_process_automationARead-only
Get details of a Process Automation Designer playbook or process
Inputs: name_or_sysid (required).
get_property_historyARead-only
Get audit history of changes to a system property
Inputs: name (required), limit.
get_quoteBRead-only
Get a CPQ/sales quote record by number or sys_id (tries known quote tables)
Inputs: table, number, sys_id.
get_recordBRead-only
Retrieve complete details of a specific record by sys_id
Inputs: table (required), sys_id (required), fields.
get_reportARead-only
Get the definition and metadata of a saved report
Inputs: sys_id_or_name (required).
get_request_itemARead-only
Get a requested item (RITM) with its variables, by number or sys_id
Inputs: number, sys_id.
get_rest_messageARead-only
Get full configuration of an outbound REST Message including its endpoints
Inputs: sys_id_or_name (required).
get_scheduled_jobARead-only
Get full details of a scheduled job by sys_id or name
Inputs: sys_id_or_name (required).
get_scoped_appARead-only
Get full details of a scoped application by sys_id or scope name
Inputs: id (required).
get_script_includeARead-only
Get full script body of a script include (requires SCRIPTING_ENABLED=true)
Inputs: sys_id_or_name (required).
get_security_dashboardARead-only
Get security posture dashboard — open incidents by severity, vulnerability counts, mean time to resolve
Inputs: days.
get_security_incidentARead-only
Get full details of a security incident by number or sys_id
Inputs: number_or_sysid (required).
get_sla_detailsARead-only
Get SLA breach status for a specific task or incident
Inputs: task_sys_id (required).
get_subflowARead-only
Get full details of a subflow including its inputs, outputs, and actions
Inputs: name_or_sysid (required).
get_survey_resultsARead-only
Get responses/scores for a survey instance or definition (asmt_assessment_instance_question)
Inputs: limit, instance, metric_type.
get_sys_logARead-only
Retrieve system log entries for debugging or auditing. Set app_scope=true to read the scoped-application log (syslog_app_scope), where scoped gs.info()/gs.log() output lands, instead of the global syslog.
Inputs: limit, query, app_scope.
get_system_propertyARead-only
Get a ServiceNow system property value and metadata by name
Inputs: name (required).
get_table_record_countARead-only
Get total record count for a ServiceNow table with optional filters
Inputs: table (required), query.
get_table_schemaBRead-only
Get the structure and field information for a ServiceNow table
Inputs: table (required).
get_taskARead-only
Get details of any task record by number or sys_id
Inputs: number_or_sysid (required).
get_task_slaARead-only
Get live SLA instances (task_sla) for a task — percent complete, breach status, stage, planned end
Inputs: task, active_only, task_number.
get_threat_intelligenceARead-only
Query threat intelligence data — IOCs, threat actors, and campaigns
Inputs: query (required), type, limit.
get_transform_mapARead-only
Get details of a Transform Map including its field mappings
Inputs: sys_id_or_name (required).
get_ui_actionARead-only
Get full details and script of a UI Action (requires SCRIPTING_ENABLED=true)
Inputs: sys_id (required).
get_uib_pageARead-only
Get details of a specific UI Builder page (screen collection) including its routes and screen variants
Inputs: sys_id (required).
get_ui_policyARead-only
Get full details and conditions of a UI Policy (requires SCRIPTING_ENABLED=true)
Inputs: sys_id (required).
get_userARead-only
Look up user details by email or username
Inputs: user_identifier (required).
get_user_entitlementsARead-only
Summarize what a user can access: their roles, groups, and active status
Inputs: user (required).
get_ux_appARead-only
Get configuration details of a Next Experience application
Inputs: sys_id_or_name (required).
get_va_conversationARead-only
Get conversation history for a Virtual Agent session
Inputs: conversation_id (required), limit.
get_va_topicARead-only
Get Virtual Agent topic details including intent and trigger phrases
Inputs: sys_id (required).
get_virtual_agent_topicsBRead-only
List Virtual Agent topics available in the instance (sys_cs_topic)
Inputs: limit, active, category.
get_vulnerabilityARead-only
Get details of a specific vulnerability entry including CVSS score and affected CIs
Inputs: number_or_sysid (required).
get_workspaceARead-only
Get details of a configurable agent workspace including tabs and lists
Inputs: sys_id (required).
grant_roleB
Grant a role to a user (sys_user_has_role). Requires WRITE_ENABLED=true
Inputs: role (required), user (required).
import_cmdb_dataC
Import CI data into CMDB via import set. [Write]
Inputs: data (required), table (required), async.
import_propertiesA
Import (create or update) system properties from a JSON object. [Write]
Inputs: properties (required), dry_run.
investigate_incidentARead-only
One-call incident investigation. Returns the incident, similar recent incidents, the affected CI with its relationships, and related knowledge articles, so the assistant does not have to chain several queries. Read-only.
Inputs: number_or_sysid (required).
list_aclsARead-only
List Access Control rules (ACLs) — who can read/write/create/delete records (requires SCRIPTING_ENABLED=true)
Inputs: limit, table, active, operation.
list_action_instancesARead-only
List Flow Designer action instances. Pass flow_id to scope to a single flow's steps (recommended); otherwise lists across the environment.
Inputs: limit, query, flow_id, category.
list_active_eventsCRead-only
Monitor critical infrastructure events
Inputs: limit, query.
list_active_slasBRead-only
List active SLA records with optional filters
Inputs: limit, query.
list_agent_evaluationsARead-only
List Otto / Now Assist evaluation runs (sys_one_extend_batch_run) for AI agents and skills: status, evaluation type (agentic_ai, conversational_ai), run type, dataset and strategy. Optionally list the available evaluation strategies.
Inputs: limit, status, run_type, usecase_id, +2 more.
list_agent_memoryARead-only
List Otto / Now Assist AI agent long-term memory entries (sn_aia_memory): semantic and episodic memories stored per user, with category, relevance score and source record.
Inputs: type, user, limit, active, +1 more.
list_agent_toolsARead-only
List the tools attached to an Otto (Now Assist) AI agent in AI Agent Studio: flow actions, subflows, scripts, topics, skills, MCP tools, etc. Reads sn_aia_agent_tool_m2m joined to sn_aia_tool. Pass an agent sys_id or exact name, or a tool to see which agents use it.
Inputs: tool, agent, limit, active.
list_agent_triggersARead-only
List Otto / Now Assist AI agent triggers (sn_aia_trigger_configuration): record-based, scheduled and channel triggers that start agentic workflows, with their target table, condition, run-as user and linked use cases/agents (sn_aia_trigger_agent_usecase_m2m).
Inputs: limit, query, active, usecase, +1 more.
list_agent_use_casesARead-only
List AI Agent Studio use cases (sn_aia_usecase) and their configuration
Inputs: limit, query.
list_ai_agent_executionsARead-only
List recent Now Assist AI Agent execution plans (sn_aia_execution_plan)
Inputs: limit, query, status.
list_ai_agentsBRead-only
List AI agent definitions (AI Agent Studio, sn_aia_agent) with their active flag from sn_aia_agent_config
Inputs: limit, active.
list_ai_approval_requestsBRead-only
List AI Control Tower assessment / approval requests (sn_ai_governance_assessment_request) and optionally their review tasks (sn_ai_governance_assessment_task) with reviewer and state.
Inputs: asset, limit, state, active, +1 more.
list_ai_assetsARead-only
List AI assets from the AI Control Tower inventory (alm_ai_digital_asset and its model / prompt / dataset / system / MCP classes), with governance status, risk and lifecycle phase (sn_ai_governance_asset_governance_details). Covers Otto (Now Assist) skills, AI agents, prompts, models and MCP servers.
Inputs: name, limit, risk_score, asset_class, +3 more.
list_ai_modified_recordsARead-only
List records that were changed by AI (Otto / Now Assist, AI agents) using the platform AI record activity log (sys_ai_record_activity): table, record and which fields AI updated. Filter by table and date range, or group counts by table.
Inputs: to, from, limit, table, +1 more.
list_ai_policiesARead-onlyIdempotent
List the guardrails that apply to Otto: sensitive-topic filters and their groups and attachments (sys_gen_ai_filter, sys_gen_ai_filter_group, sys_gen_ai_filter_config), Guardian providers and custom transformers, and guardrail properties. AI Control Tower policy tables are included when the installed version has them (none exist on sn_ai_governance 5.0.6).
Inputs: limit, active_only.
list_application_servicesARead-only
List discovered application services (cmdb_ci_service_auto), optionally by name or operational status. Parity with ServiceNow get_all_application_service_names
Inputs: limit, query, operational_status.
list_approvalsBRead-only
List approval requests with optional filters
Inputs: limit, query, state.
list_assessmentsARead-only
List survey/assessment instances (asmt_assessment_instance) by state or user
Inputs: user, limit, state, metric_type.
list_asset_contractsARead-only
List asset maintenance and support contracts
Inputs: limit, active, asset_sys_id.
list_assetsARead-only
List IT assets with optional filtering by state, class, or assigned user
Inputs: limit, query, state, location, +2 more.
list_atf_suitesARead-only
List ATF test suites in the instance
Inputs: limit, query, active.
list_atf_test_resultsARead-only
List individual test results within a suite run
Inputs: limit, suite_result_sys_id.
list_atf_testsARead-only
List ATF test cases, optionally filtered by suite
Inputs: limit, active, suite_sys_id.
list_attachmentsARead-only
List attachments associated with a specific record
Inputs: table (required), record_sys_id (required), limit.
list_audit_resultsBRead-only
List audit results and findings
Inputs: limit, state, severity.
list_breached_slasARead-only
List SLA instances that have breached or are at risk within a window (task_sla)
Inputs: limit, breached, sla_table, min_percentage.
list_business_rulesARead-only
List business rules (requires SCRIPTING_ENABLED=true)
Inputs: limit, table, active.
list_catalog_categoriesARead-only
List catalog categories (sc_category), optionally filtered by catalog or title
Inputs: limit, query, catalog.
list_catalog_itemsBRead-only
List available service catalog items
Inputs: limit, category.
list_catalog_tasksCRead-only
List catalog fulfillment tasks (SCTASK), optionally by request item, assignment group, or state
Inputs: limit, active, request_item, assignment_group.
list_change_requestsARead-only
List change requests with optional filtering by state or query
Inputs: limit, query, state.
list_changesetsBRead-only
List update sets (changesets) (requires SCRIPTING_ENABLED=true)
Inputs: limit, state.
list_client_scriptsBRead-only
List client scripts (requires SCRIPTING_ENABLED=true)
Inputs: type, limit, table, active.
list_compliance_policiesARead-only
List GRC compliance policies and their current status
Inputs: limit, state.
list_credential_aliasesARead-only
List connection and credential aliases used by integrations
Inputs: type, limit, query.
list_csm_accountsCRead-only
List customer accounts with optional search filter
Inputs: limit, query, active.
list_csm_casesBRead-only
List CSM cases with optional filters (account, contact, state, priority)
Inputs: limit, query, state, account, +2 more.
list_csm_case_tasksARead-only
List the tasks on a CSM case (sn_customerservice_task). Parity with ServiceNow CSM "Get Case Tasks"
Inputs: case (required), limit, active.
list_csm_contactsARead-only
List contacts for an account or search across all contacts
Inputs: limit, query, account_sysid.
list_csm_productsBRead-only
List products and services available in the CSM catalog
Inputs: limit, query.
list_data_sourcesARead-only
List Import Set data source definitions (file/JDBC/REST loaders)
Inputs: type, limit, query.
list_decision_answersBRead-only
List the answer/result rows of a decision table
Inputs: decision_sys_id (required), limit.
list_decision_inputsBRead-only
List the inputs of a decision table
Inputs: decision_sys_id (required).
list_decision_tablesARead-only
List Decision Builder decision tables (sys_decision), optionally filtered by name or active status
Inputs: limit, query, active.
list_demandsBRead-only
List SPM demands (dmn_demand) — the intake pipeline that feeds projects.
Inputs: limit, query, fields.
list_deployment_historyBRead-only
List deployment history — committed update sets and app installs over time
Inputs: days, limit.
list_deploymentsBRead-only
List recent application deployments tracked in ServiceNow
Inputs: limit, state, environment, pipeline_sys_id.
list_devops_pipelinesARead-only
List DevOps pipeline configurations registered in ServiceNow
Inputs: limit, active.
list_discovery_schedulesARead-only
List discovery schedules and their run status
Inputs: active_only.
list_email_logsARead-only
List outbound email log entries to track sent/failed emails
Inputs: limit, state, subject, recipient.
list_email_templatesARead-only
List email notification templates used by notifications
Inputs: limit, query.
list_epicsARead-only
List epics with optional project or state filter
Inputs: limit, state, project.
list_event_logARead-only
List recent event log entries (fired events and their processing status)
Inputs: limit, state, event_name.
list_event_registryARead-only
List registered event definitions in the ServiceNow event registry
Inputs: limit, query.
list_external_agentsARead-only
List external (third-party) AI agents registered for Otto / Now Assist A2A (Agent2Agent) use: providers (sn_aia_external_agent_provider), protocols, discovery configs, agent cards and skills, connection configurations, and sn_aia_agent records of type external.
Inputs: limit.
list_flow_executionsBRead-only
List recent executions of a flow with status (completed, error, running)
Inputs: flow_sys_id (required), limit, status.
list_flowsARead-only
List Flow Designer flows with optional filter by name, category, or active status
Inputs: limit, query, active, category.
list_goalsBRead-only
List SPM goals (sn_gf_goal) — the strategic goals portfolios and programs align to.
Inputs: limit, query, fields.
list_grc_controlsBRead-only
List GRC controls with optional filter by risk or policy
Inputs: limit, state, risk_sysid.
list_grc_issuesARead-only
List GRC issues/findings (sn_grc_issue), optionally by state or owner
Inputs: limit, owner, query, state.
list_grc_risksARead-only
List GRC (Governance, Risk, Compliance) risk entries
Inputs: limit, state, category.
list_group_membersBRead-only
List the members of a group (sys_user_grmember)
Inputs: group (required), limit.
list_groupsARead-only
List groups with optional search filter
Inputs: limit, query.
list_homepagesARead-only
List homepage dashboards (CMS content pages used as homepages)
Inputs: limit, query.
list_hr_casesARead-only
List HR cases with optional filters (status, subject person, service)
Inputs: limit, query, state, hr_service, +1 more.
list_hr_document_templatesARead-only
List available HR document templates (offer letters, contracts, policies)
Inputs: limit, active, category.
list_hr_servicesBRead-only
List available HR services (Onboarding, Offboarding, Benefits, Payroll, etc.)
Inputs: limit, query, active.
list_hr_tasksARead-only
List HR tasks associated with an HR case
Inputs: hr_case_sysid (required), state.
list_import_setsBRead-only
List Import Sets with optional filter by state or staging table
Inputs: limit, query, state.
list_instancesARead-only
List all configured ServiceNow instances (multi-instance / multi-customer support)
Inputs: no named parameters.
list_job_run_historyARead-only
List recent run history for scheduled jobs (success/failure log)
Inputs: limit, status, job_sys_id.
list_jobsARead-only
List your background jobs (newest first) with their status and progress. Finished jobs are kept for an hour.
Inputs: limit, status.
list_kg_context_configsBRead-only
List Knowledge Graph configuration used by Otto (Now Assist) and AI agents for grounding: graphs (sys_meta_graph), context configs (sn_kg_context_config), related-data connector maps (sn_kg_related_data_map) and use case mappings (knowledge_graph_use_case_mapping).
Inputs: limit, include_configuration.
list_knowledge_basesARead-only
List all knowledge bases available in the instance
Inputs: limit.
list_mid_serversARead-only
List MID servers and verify they are healthy
Inputs: active_only.
list_mobile_app_configsBRead-only
List ServiceNow mobile app configurations
Inputs: limit, active.
list_mobile_appletsBRead-only
List mobile applets (mini-apps within the mobile experience)
Inputs: limit, app_config.
list_mobile_layoutsCRead-only
List mobile layout configurations
Inputs: limit.
list_my_tasksARead-only
List tasks assigned to the currently configured user
Inputs: limit.
list_notificationsARead-only
List email notification definitions (sysevent_email_action)
Inputs: event, limit, query, table, +1 more.
list_notification_subscriptionsARead-only
List user subscriptions to notifications (who has opted in/out)
Inputs: limit, user_sys_id, notification_sys_id.
list_now_assist_skillsARead-only
List Now Assist skill definitions (requires NOW_ASSIST_ENABLED)
Inputs: limit, query, active.
list_oauth_applicationsARead-only
List OAuth application registry entries (client applications that can authenticate)
Inputs: limit, query.
list_otto_channelsARead-only
List where Otto (Now Assist) is deployed: assistant deployments (sys_now_assist_deployment: Otto panel, Virtual Agent, voice), their channels (sys_now_assist_deployment_channel) and configuration attributes such as which skills are enabled (sys_now_assist_deployment_config_attributes).
Inputs: active, include_attributes.
list_pa_breakdownsARead-only
List PA breakdowns (dimensions) available for segmenting indicator data
Inputs: limit, query.
list_pa_dashboardsARead-only
List Performance Analytics dashboards
Inputs: limit, query.
list_pa_indicatorsARead-only
List Performance Analytics (PA) indicators (KPIs) available in the instance
Inputs: limit, query, active, category.
list_pa_jobsARead-only
List Performance Analytics data collection jobs and their schedules
Inputs: limit, query, active.
list_playbooksBRead-only
List stored NowAIKit playbook definitions (system properties nowaikit.playbook.*)
Inputs: limit.
list_portal_pagesARead-only
List pages that belong to a Service Portal
Inputs: portal_sys_id (required), limit, query.
list_portalsARead-only
List all Service Portal configurations available in the instance
Inputs: limit, query.
list_portal_themesBRead-only
List Service Portal themes (color palettes, CSS variables)
Inputs: limit.
list_portal_widgetsBRead-only
List Service Portal widgets with optional search by name or category
Inputs: limit, query.
list_portfoliosBRead-only
List Strategic Portfolio Management portfolios (pm_portfolio). SPM is the evolution of PPM.
Inputs: limit, query, fields.
list_process_automationsBRead-only
List Process Automation Designer playbooks and processes
Inputs: limit, query, active.
list_programsCRead-only
List SPM programs (pm_program).
Inputs: limit, query, fields.
list_projectsBRead-only
List SPM projects (pm_project).
Inputs: limit, query.
list_project_tasksARead-only
List project tasks (pm_project_task), optionally scoped to a parent project.
Inputs: limit, query, project_sys_id.
list_property_categoriesARead-only
List all unique property categories with their record counts
Inputs: no named parameters.
list_quotesARead-only
List CPQ/sales quotes with optional filters (state, account)
Inputs: limit, state, table, account.
list_relationshipsBRead-only
Show parent and child relationships for a CI
Inputs: ci_sys_id (required).
list_reportsARead-only
List saved reports in the instance (latest release: /api/now/reporting)
Inputs: limit, search, category.
list_rest_message_functionsARead-only
List HTTP methods (functions) defined within a REST Message
Inputs: rest_message_sys_id (required), limit.
list_rest_messagesARead-only
List outbound REST Message configurations (integrations with external APIs)
Inputs: limit, query.
list_rotasARead-only
List on-call rotations (cmn_rota), optionally filtered by group or name
Inputs: group, limit, query.
list_scan_suitesBRead-only
List Instance Scan suites (scan_suite) available to run
Inputs: limit, query.
list_scheduled_jobsARead-only
List scheduled jobs and their run schedules
Inputs: limit, query, active.
list_scoped_appsARead-only
List scoped applications (custom apps) installed in the instance
Inputs: limit, query, active.
list_script_includesARead-only
List script includes (requires SCRIPTING_ENABLED=true)
Inputs: limit, query, active.
list_scrum_tasksBRead-only
List scrum tasks, optionally filtered by story
Inputs: limit, assigned_to, story_sys_id.
list_security_incidentsARead-only
List security incidents with filters (severity, state, category)
Inputs: limit, query, state, category, +1 more.
list_security_playbooksBRead-only
List available security response playbooks
Inputs: limit, active, category.
list_service_offeringsBRead-only
List service offerings (service_offering), optionally by parent business service
Inputs: limit, query, parent.
list_sla_definitionsARead-only
List SLA/OLA definitions (contract_sla), optionally filtered by name, table, or active status
Inputs: limit, query, table, active.
list_software_licensesARead-only
List software license records with compliance status
Inputs: limit, query.
list_storiesARead-only
List agile stories with optional sprint or state filter
Inputs: limit, state, sprint.
list_story_dependenciesARead-only
List dependency links for a story (m2m_story_dependencies).
Inputs: story (required), limit.
list_subflowsARead-only
List available subflows that can be reused across flows
Inputs: limit, query, active.
list_supported_artifactsARead-only
Local sync: list the artifact types (tables) that support pull/push to local files and which fields sync for each.
Inputs: no named parameters.
list_system_propertiesCRead-only
List system properties with optional filtering
Inputs: type, limit, query, category.
list_table_configARead-only
List every configuration artifact on a table — business rules, client scripts, UI policies, ACLs, UI actions, data policies, and dictionary fields — with per-type counts. Use it to see what depends on a table before changing or removing it. This is config/metadata impact, not CMDB CI impact. Each lane returns {count, records} or {error} if that table/plugin is unavailable.
Inputs: table (required), limit.
list_transform_field_mapsARead-only
List field-level mappings within a Transform Map
Inputs: transform_map_sys_id (required), limit.
list_transform_mapsBRead-only
List Transform Maps used for importing data into ServiceNow tables
Inputs: limit, query, target_table.
list_ui_actionsARead-only
List UI Actions (buttons, context menus, related links) for a table (requires SCRIPTING_ENABLED=true)
Inputs: type, limit, table, active.
list_uib_componentsARead-only
List available UI Builder components (macroponents) in the instance
Inputs: limit, scope.
list_uib_data_brokersARead-only
List UI Builder data brokers (data sources for pages)
Inputs: limit, page_sys_id.
list_uib_pagesBRead-only
List UI Builder pages (app routes with their screen collections) and their route configurations
Inputs: app, limit.
list_ui_policiesARead-only
List UI Policies for a table (field visibility, mandatory, read-only rules) (requires SCRIPTING_ENABLED=true)
Inputs: limit, table, active.
list_update_setsBRead-only
List Update Sets by state (in progress, complete, ignore)
Inputs: limit, query, state.
list_user_rolesARead-only
List roles granted to a user (sys_user_has_role), including inherited flag
Inputs: user (required).
list_usersBRead-only
List users with optional search filter
Inputs: limit, query.
list_ux_appsARead-only
List Next Experience (UI Builder) applications
Inputs: limit, query.
list_ux_pagesBRead-only
List pages within a Next Experience (UI Builder) application
Inputs: app_sys_id (required), limit, query.
list_va_categoriesARead-only
List Virtual Agent topic categories
Inputs: limit.
list_va_conversationsARead-only
List recent Virtual Agent conversations
Inputs: limit, user_sys_id, topic_sys_id.
list_va_topics_fullCRead-only
List all Virtual Agent topics with category and status details
Inputs: limit, query, active, category.
list_vulnerabilitiesBRead-only
List vulnerability entries from the Vulnerability Response module
Inputs: limit, query, state, ci_sysid, +1 more.
list_widget_instancesARead-only
List instances of a specific widget placed on portal pages
Inputs: widget_sys_id (required), limit.
list_workspacesBRead-only
List all configurable agent workspaces
Inputs: limit, active.
mcp_health_checkARead-only
Health check: confirm the instance is reachable and the configured credentials resolve to a valid user. Parity with ServiceNow MCP "Health Check"
Inputs: no named parameters.
ml_auto_categorizeARead-only
Auto-categorize a record based on its description by analysing resolved records of the same table. Queries the last 500 resolved records, groups by category, and matches input keywords to suggest a category.
Inputs: short_description (required), table, description.
ml_detect_anomaliesARead-only
Run anomaly detection on operational metrics (alert volume, incident trends, etc.)
Inputs: field (required), table (required), days, threshold.
ml_evaluate_modelARead-only
Get accuracy, training status, and metrics for a trained ML solution
Inputs: model_sys_id (required).
ml_forecast_incidentsBRead-only
Forecast incident volume for the next N days based on historical trends
Inputs: async, category, priority, days_ahead.
ml_model_training_historyARead-only
Get training run history and accuracy trends for an ML solution over time
Inputs: model_sys_id (required), days.
ml_predict_change_riskBRead-only
Predict the risk level of a change request using historical ML analysis
Inputs: type, category, change_sys_id.
ml_process_optimizationARead-only
Identify process bottlenecks using analysis of task durations and reassignment patterns
Inputs: table (required), days.
ml_similar_incidentsARead-only
Find similar past incidents using keyword-based matching. Provide either an incident sys_id (to find similar incidents) or a short_description (for free-text matching). Returns resolved incidents ranked by keyword match count.
Inputs: limit, incident_sys_id, short_description.
ml_train_anomaly_detectorC
Trigger training of an anomaly detection model for a specific table/field. [Write]
Inputs: field (required), table (required), async.
ml_train_change_riskC
Trigger training of the change risk prediction ML model. [Write]
Inputs: async, dry_run, solution_name.
ml_train_incident_classifierC
Trigger training of the incident classification ML solution. [Write]
Inputs: async, dry_run, solution_name.
ml_virtual_agent_nluARead-only
Analyse Virtual Agent NLU performance — conversation completion rates and fallback metrics
Inputs: days, topic_sys_id.
natural_language_searchCRead-only
Search ServiceNow using plain English
Inputs: query (required), limit.
natural_language_updateB
Update a record from a plain-English instruction such as "set priority to 2 on INC0010001" (requires WRITE_ENABLED=true)
Inputs: table (required), instruction (required), dry_run.
nlq_queryBRead-only
Ask a natural language question and get structured ServiceNow data (ServiceNow NLQ API)
Inputs: question (required), limit, table.
open_approvalsARead-only
Show the current user's pending approvals as an interactive list with Approve and Reject buttons inside the chat. Hosts without MCP Apps get the list as JSON.
Inputs: limit.
open_catalog_formARead-only
Open a Service Catalog item as an interactive request form inside the chat (Claude, ChatGPT, VS Code and other MCP Apps hosts). The user fills in the variables, with choices, reference lookups, variable sets and catalog UI policies applied, and submits the request themselves. Prefer this over asking the user for each variable. Pass the item sys_id or its name. Hosts without MCP Apps get the form definition as JSON.
Inputs: item (required).
open_record_formARead-only
Open an interactive form to create or edit a ServiceNow record (incident, change_request, problem, any table) inside the chat. Fields follow the table's default form layout, with choice lists, dependent choices and reference lookups. Omit sys_id to create a new record; pass values to prefill. The user reviews and saves.
Inputs: table (required), fields, sys_id, values.
order_catalog_itemA
Order a service catalog item (requires WRITE_ENABLED=true)
Inputs: sys_id (required), quantity, variables.
preview_approval_routingB
Preview the planned approver path for a record before/after submission (existing sysapproval_approver rows + matching approval rules)
Inputs: record (required), table.
preview_update_setC
Preview all changes contained in an Update Set
Inputs: sys_id (required), async, limit.
publish_changesetA
Publish/export an update set to XML for deployment (requires SCRIPTING_ENABLED=true)
Inputs: sys_id (required).
publish_decision_tableA
Publish a Decision Builder decision table — sets sys_decision.status to "published". Requires WRITE_ENABLED=true
Inputs: decision_sys_id (required).
publish_flowA
Publish a draft flow or subflow (compiles and activates it via sn_fd.FlowAPI.publish; needs SCRIPTING_ENABLED). [Write]
Inputs: flow_sys_id (required), type.
publish_knowledge_articleA
Publish a draft knowledge article (requires WRITE_ENABLED=true)
Inputs: sys_id (required).
pull_artifactARead-only
Local sync: fetch an artifact's editable fields (e.g. a Service Portal widget's template/css/script) for local editing. Returns the content inline; when NOWAIKIT_SYNC_DIR is set it also writes one file per field and returns the paths. This is config/pro-code editing of a single artifact, not an update-set export.
Inputs: table (required), sys_id (required).
push_artifactA
Local sync: write edited fields back to an artifact (requires WRITE_ENABLED=true). Pass fields inline as {field:value}; if omitted and NOWAIKIT_SYNC_DIR is set, reads them from the pulled files on disk. Overwrites the listed fields with NO merge — run sync_status first, and pass expected_updated_on to abort if the instance changed since you pulled.
Inputs: table (required), sys_id (required), fields, expected_updated_on.
query_recordsARead-only
Query ServiceNow records with filtering, field selection, pagination, and sorting
Inputs: table (required), limit, query, fields, +1 more.
read_attachmentARead-only
Read an existing ServiceNow attachment and return its text content, server-side. Works for text formats (txt, csv, json, xml, html, md, log). Binary formats (PDF, DOCX, images) return metadata plus a note. Use this to summarise or draft from a file already in ServiceNow.
Inputs: attachment_sys_id (required), max_chars.
recall_approval_requestA
Recall/withdraw approval requests on a record by cancelling pending approver rows (state → cancelled/no_longer_required). Requires WRITE_ENABLED=true
Inputs: record (required).
register_eventA
Register a new custom event in the event registry (requires SCRIPTING_ENABLED=true)
Inputs: name (required), table (required), queue, fired_by, +1 more.
reject_requestADestructive
Reject a pending approval request (requires WRITE_ENABLED=true)
Inputs: sys_id (required), comments (required).
remove_user_from_groupADestructive
Remove a user from a group (requires WRITE_ENABLED=true)
Inputs: member_sys_id (required).
resolve_incidentB
Resolve an incident with resolution code and notes (requires WRITE_ENABLED=true)
Inputs: sys_id (required), resolution_code (required), resolution_notes (required).
resolve_problemA
Resolve a problem with root cause and resolution notes (requires WRITE_ENABLED=true)
Inputs: sys_id (required), root_cause (required), resolution_notes (required), assigned_to, +1 more.
resubmit_ecc_probeA
Re-queue an ECC probe/sensor by setting its state back to ready (ecc_queue). Requires WRITE_ENABLED=true
Inputs: sys_id (required).
retire_assetADestructive
Retire an IT asset (mark as disposed/retired). [Write]
Inputs: sys_id (required), disposal_date, disposal_reason.
retire_knowledge_articleADestructive
[Write] Retire a knowledge article (mark as outdated)
Inputs: article_id (required).
revoke_roleADestructive
Revoke a directly-granted role from a user. Requires WRITE_ENABLED=true
Inputs: role (required), user (required).
rollback_changesADestructive
Delete a set of previously-created records, e.g. the rollback_token returned by bulk_create_records. Requires WRITE_ENABLED=true.
Inputs: changes (required).
rollback_deploymentADestructive
Rollback a deployment by reverting an update set. [Write]
Inputs: update_set_sys_id (required), reason.
run_aggregate_queryC
Run a grouped aggregate (COUNT, SUM, AVG) query on any table (latest release: /api/now/stats/{table})
Inputs: table (required), group_by (required), limit, query, +1 more.
run_atf_suiteB
Execute an ATF test suite (requires ATF_ENABLED=true)
Inputs: sys_id (required), async.
run_atf_testB
Execute a single ATF test (requires ATF_ENABLED=true)
Inputs: sys_id (required), async.
run_control_testA
Record a control test result: an indicator result (sn_grc_indicator_result) on the control's manual indicator, which is created if the control has none. Requires WRITE_ENABLED=true
Inputs: control (required), async, notes, fields, +2 more.
run_discovery_scanC
[Write] Trigger a ServiceNow Discovery scan for network/infrastructure
Inputs: schedule_id (required), async, mid_server.
run_fix_scriptA
Execute a fix script (sys_script_fix) by name or sys_id on the server. Requires WRITE_ENABLED=true and SCRIPTING_ENABLED=true
Inputs: name, async, sys_id.
run_security_playbookC
Execute a security response playbook against an incident. [Write]
Inputs: incident_sys_id (required), playbook_sys_id (required), async, parameters.
run_transform_mapA
Execute a Transform Map on an Import Set to load data (runs GlideImportSetTransformer server-side; requires WRITE_ENABLED and SCRIPTING_ENABLED)
Inputs: import_set_sys_id (required), transform_map_sys_id (required), async.
scan_vulnerabilitiesC
Trigger a vulnerability scan for specified CIs or groups. [Write]
Inputs: async, group, scan_type, ci_sys_ids.
schedule_cab_meetingC
[Write] Schedule a Change Advisory Board (CAB) meeting
Inputs: date (required), change_id (required), attendees, duration_minutes.
schedule_notificationB
[Write] Explain how to send a notification at a set time. ServiceNow notifications are event/condition driven and have no schedule of their own, so this returns NOT_SUPPORTED with the scheduled-job alternative and changes nothing
Inputs: schedule (required), notification_id (required), active.
search_catalogARead-only
Search the service catalog for items matching a keyword
Inputs: query (required), limit.
search_cmdb_ciCRead-only
Search for configuration items (CIs) in the CMDB
Inputs: limit, query.
search_hr_knowledgeARead-only
Search HR-scoped knowledge articles (kb_knowledge in HR knowledge bases). Parity with ServiceNow HRSD "HR Knowledge Search"
Inputs: query (required), kb, limit.
search_knowledgeBRead-only
Search knowledge base articles by keyword
Inputs: query (required), limit, knowledge_base.
search_servicenow_docsARead-only
Search the official ServiceNow product documentation (servicenow.com/docs) — API references (GlideRecord, GlideSystem, GlideAjax…), admin & developer guides, encoded-query operators, release notes. Returns ranked results with title, breadcrumb, URL, snippet, and a ref to read the full page with fetch_servicenow_doc. Use this to ground answers in current ServiceNow docs rather than memory. Read-only; uses the public docs site, not your instance.
Inputs: query (required), limit, product.
search_system_propertiesARead-only
Search system properties by name, value, or description
Inputs: search (required), limit.
search_toolsARead-only
Search the full NowAIKit tool catalog (500+ tools) by keyword to discover the right tool without loading every definition. Returns matching tool names + descriptions ranked by relevance. Use this FIRST when you are unsure which tool to call. Especially useful with MCP_TOOL_DISCOVERY=lean, which exposes only a small core set plus this search.
Inputs: query (required), limit.
send_emergency_broadcastBDestructive
[Write] Send emergency broadcast notification to users or groups
Inputs: body (required), subject (required), recipients (required), channels.
send_push_notificationADestructive
Send a push notification to ServiceNow mobile app users (Now Mobile / Mobile Agent) the way ServiceNow does it: an event fires a push-only notification whose push message carries the text. The first call per table sets up, and later calls reuse, an event "nowaikit.push", a push message "NowAIKit push ()" and a notification "NowAIKit push ()". Only users signed in to the mobile app with push enabled receive it; the result says how many recipients have a registered device. [Write]
Inputs: body (required), title (required), user, group, +7 more.
send_surveyB
Issue a survey/assessment instance to a user (asmt_assessment_instance). Requires WRITE_ENABLED=true
Inputs: user (required), metric_type (required), fields, trigger_id, +1 more.
service_healthARead-only
One-call service health snapshot. Returns a business service or CI, its open incidents, related CIs, and recent changes. Read-only.
Inputs: name_or_sysid (required).
service_mapping_summaryARead-only
View service dependencies and related CIs for impact analysis
Inputs: service_sys_id (required).
set_system_propertyBIdempotent
Create or update a ServiceNow system property value. [Write]
Inputs: name (required), value (required), type, description.
sn_a2a_expose_agentA
Turn third-party (A2A) access on or off for a ServiceNow AI agent ("Allow third party to access this AI agent"). REQUIRES WRITE_ENABLED=true and AI agent admin rights.
Inputs: agent (required), exposed.
sn_a2a_get_agent_cardBRead-only
Fetch the A2A agent card of a ServiceNow AI agent (skills, capabilities, supported protocol versions).
Inputs: agent (required).
sn_a2a_get_taskARead-only
Get the status and result of an A2A task started with sn_a2a_send_message.
Inputs: agent (required), task_id (required).
sn_a2a_list_agentsARead-only
List ServiceNow AI agents (Otto / AI Agent Studio) and whether each is exposed to external callers over A2A, with its agent card URL.
Inputs: limit, search, exposed_only.
sn_a2a_send_messageA
Send a message to a ServiceNow AI agent over A2A and return its reply (or the task when it needs more input or runs async). Pass context_id / task_id from a previous reply to continue the conversation. The agent acts with its own tools, so this REQUIRES WRITE_ENABLED=true.
Inputs: agent (required), message (required), task_id, context_id, +1 more.
sn_mcp_activate_serverA
Activate or deactivate a ServiceNow MCP server, and optionally attach tool definitions to it by name (admin setup helper for MCP Server Console). REQUIRES WRITE_ENABLED=true and the sn_mcp_server.admin role.
Inputs: server (required), status, add_tools.
sn_mcp_add_toolA
Add a tool to an MCP Server Console server. Either attach an existing tool definition (tool), or register a new one from a Now Assist / Otto skill (skill → sn_mcp_ai_skill_tool_definition, inputs copied from the skill's input attributes) or a Scripted REST operation (rest_operation → sn_mcp_scripted_rest_tool_definition, inputs you list). These are the two tool sources MCP Server Console offers; to expose a subflow, action, Knowledge Graph or AI Search, wrap it in a Now Assist skill or a Scripted REST operation first. REQUIRES WRITE_ENABLED=true and sn_mcp_server.admin.
Inputs: server (required), name, tool, label, +4 more.
sn_mcp_call_toolA
Call a tool on one of the instance's own MCP servers (Now Assist / Otto skills, subflows, actions, Knowledge Graph, scripted REST tools). Runs as the signed-in user and consumes Now Assist entitlement like any MCP call. Tools that ServiceNow does not mark read-only need WRITE_ENABLED=true.
Inputs: tool (required), server (required), arguments.
sn_mcp_create_serverA
Create a server in ServiceNow MCP Server Console (sn_mcp_server_registry), optionally with tools attached. The endpoint is /sncapps/mcp-server/mcp/. A draft server creates only the registry row. When the server is (or later becomes) active, ServiceNow itself auto-creates: an OAuth client in Application Registry named like the server (redirect mcp_redirect.do, JWT tokens), an AutoGen OAuth provider with profile and resource, an AutoGen connection alias with HTTP connection, OAuth 2.0 credential and Workflow Data Fabric mapping, an auth server connection, a default-allow execute ACL named after the endpoint, and AI Control Tower records (product model, CI, digital asset). For an active server this tool waits for those and returns them. Remove everything with sn_mcp_delete_server. REQUIRES WRITE_ENABLED=true and the sn_mcp_server.admin role.
Inputs: label (required), name, tools, status, +2 more.
sn_mcp_delete_serverADestructive
Delete an MCP Server Console server and, by default, the OAuth client, AutoGen provider/alias/connection/credential, WDF mapping, execute ACL and AI Control Tower records ServiceNow created for it. Tool definitions are detached, not deleted. Out-of-box (scoped) servers are refused. Records this user cannot delete (the ACL needs security_admin) are returned as leftovers with sys_ids. REQUIRES WRITE_ENABLED=true.
Inputs: server (required), cleanup_auto_created.
sn_mcp_list_registryARead-only
List the EXTERNAL MCP servers registered on the instance's MCP client (sn_mcp_server, used by AI Agent Studio to give ServiceNow AI agents tools from outside MCP servers), with endpoint URL, auth, the AI agent tools built on each, and whether MCP tools are enabled for AI agents (sn_aia.enable_mcp_tool).
Inputs: search.
sn_mcp_list_serversARead-only
List the ServiceNow MCP servers defined on the instance (MCP Server Console registry, including out-of-box ITSM, ITOM, CMDB and SPM servers when installed), with status, endpoint URL and attached tools.
Inputs: status.
sn_mcp_list_toolsARead-only
List the tools a ServiceNow MCP server exposes (live tools/list over MCP, with input schemas and annotations). Needs an OAuth (JWT) sign-in; see sn_mcp_status.
Inputs: server (required).
sn_mcp_register_external_serverA
Register an external MCP server (for example the NowAIKit hosted gateway, https://mcp.nowaikit.com/mcp) on the instance's MCP client so ServiceNow AI agents can use its tools. Creates a connection alias, an HTTP connection with the URL, an optional API key credential, and the sn_mcp_server record. Pass connection_alias to reuse an alias you already set up (for OAuth). Adding the server's tools to an agent is then done in AI Agent Studio. REQUIRES WRITE_ENABLED=true and admin.
Inputs: name (required), url, api_key, api_key_header, +2 more.
sn_mcp_remove_toolADestructive
Detach a tool from an MCP Server Console server. With delete_definition=true the definition and its inputs are also deleted, but only when no other server uses it and it is not an out-of-box (scoped) definition. REQUIRES WRITE_ENABLED=true.
Inputs: tool (required), server (required), delete_definition.
sn_mcp_statusARead-only
Check whether this instance's own MCP servers (ServiceNow MCP Server Console, Action Fabric) are usable from here: endpoint health, OAuth/JWT readiness of the current connection, and each server's status and tool count, with fixes.
Inputs: no named parameters.
sn_mcp_unregister_external_serverADestructive
Remove an external MCP server from the instance's MCP client registry (sn_mcp_server) and, unless keep_connection is true, the connection alias, HTTP connection and credential created for it. Refused while AI agent tools still use the server. REQUIRES WRITE_ENABLED=true.
Inputs: server (required), keep_connection.
submit_change_for_approvalA
Move a change request to "Requested" state for approval (requires WRITE_ENABLED=true)
Inputs: sys_id (required).
submit_for_approvalA
Submit any record for approval by setting its approval field to "requested" (generic, not just change). Requires WRITE_ENABLED=true
Inputs: table (required), sys_id (required), approval_field.
suggest_ci_classARead-only
Suggest the correct CMDB CI class for a keyword before creating a CI (cmdb_class_info). Parity with ServiceNow Get_SimilarCI_Classes
Inputs: keyword (required), limit.
summarize_recordARead-only
Summarize a record (incident/case/etc.) using the Now Assist summarization skill when available, otherwise return the assembled record + activity for the caller to summarize. Parity with ServiceNow Quickstart incident/case summarization
Inputs: table (required), record (required).
switch_instanceAIdempotent
Switch the active ServiceNow instance for this session
Inputs: name (required).
switch_update_setAIdempotent
Switch the active Update Set context to a specified Update Set. [Scripting]
Inputs: sys_id (required).
sync_statusARead-only
Local sync: compare an artifact's current instance content against your local/edited content field-by-field. Each field reports unchanged | changed | not_local (no local copy to compare). Also returns sys_updated_on to feed into push_artifact's conflict check.
Inputs: table (required), sys_id (required), fields.
test_agent_accessARead-onlyIdempotent
Answer "can this user use this AI agent, agentic workflow or Now Assist skill?" with the reasons. Works it out from the instance data: whether the asset is active, its execute ACLs (types gen_ai_agent, gen_ai_workflow, gen_ai_skill, falling back to the type's wildcard rule), the roles on those ACLs, the skill role filter (in_product_roles) and the user's active roles. Also reports data access: run-as user and role masking (sys_agent_access_role_configuration). ACL conditions, scripts and custom security attributes are reported as not evaluated, and the verdict is then undetermined. This models the platform check. It is not ServiceNow's own "Test access" (AI Agent Studio, Brazil) or Access Analyzer, which have no documented REST API.
Inputs: user (required), target (required), target_type.
test_flowA
Run a published flow or subflow synchronously (foreground) with sample inputs and return its context id and outputs (needs SCRIPTING_ENABLED). [Write]
Inputs: flow_sys_id (required), async, test_inputs.
test_now_assist_skillB
Invoke a Now Assist skill with test input to verify behavior (requires NOW_ASSIST_ENABLED)
Inputs: test_input (required), skill_sys_id (required), async.
track_asset_lifecycleC
Track asset lifecycle events and stage transitions
Inputs: asset_id (required), new_stage (required), notes.
track_deploymentB
Record a deployment event in ServiceNow (a DevOps task execution, linked to the pipeline deploy step and environment when they exist) for audit and velocity tracking. [Write]
Inputs: status (required), environment (required), artifact_name (required), notes, +3 more.
trend_queryARead-only
Get time-bucketed trend data for a table (useful for monthly/weekly trend charts)
Inputs: table (required), group_by (required), date_field (required), query, +1 more.
trigger_flowA
Trigger a published Flow Designer flow or subflow in the background with optional inputs, via the server-side sn_fd.FlowAPI runner (requires WRITE_ENABLED=true and SCRIPTING_ENABLED=true; ServiceNow has no REST endpoint for this)
Inputs: flow_sys_id (required), async, inputs.
trigger_scheduled_jobA
Immediately execute a scheduled job on-demand (requires WRITE_ENABLED=true)
Inputs: sys_id (required), async.
update_aclAIdempotent
Update an existing ACL rule (requires SCRIPTING_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_assetCIdempotent
Update an IT asset record. [Write]
Inputs: fields (required), sys_id (required).
update_business_ruleAIdempotent
Update a business rule (requires SCRIPTING_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_catalog_itemAIdempotent
Update an existing catalog item (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_change_requestAIdempotent
Update fields on a change request (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_client_scriptAIdempotent
Update an existing client script (requires SCRIPTING_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_csm_caseAIdempotent
Update fields on an existing CSM case (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_dashboardAIdempotent
Update an existing PA dashboard (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_epicAIdempotent
Update an epic (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_flowAIdempotent
Update a flow or subflow's METADATA only (activate/deactivate, name, description, run-as). [Write] NOTE: this cannot safely insert or edit flow STEPS. Flow Designer executes a compiled snapshot, and writing action-instance rows over REST does not recompile the flow, which would desync/corrupt it. Edit steps in the Flow Designer UI.
Inputs: flow_sys_id (required), name, type, active, +2 more.
update_groupAIdempotent
Update a group (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_hr_caseAIdempotent
Update fields on an existing HR case (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_hr_profileAIdempotent
Update HR profile fields for a user (requires WRITE_ENABLED=true)
Inputs: fields (required), user_sys_id (required).
update_incidentAIdempotent
Update fields on an existing incident (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_knowledge_articleAIdempotent
Update a knowledge article (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_notificationAIdempotent
Update an existing email notification (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_portal_widgetAIdempotent
Update an existing Service Portal widget's source code (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_problemAIdempotent
Update fields on an existing problem (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_projectAIdempotent
Update a SPM project (pm_project). Requires WRITE_ENABLED=true.
Inputs: fields (required), sys_id (required).
update_recordAIdempotent
Update an existing record in any ServiceNow table (requires WRITE_ENABLED=true). Pass dry_run=true to preview a before→after field diff without writing.
Inputs: table (required), fields (required), sys_id (required), dry_run.
update_reportAIdempotent
Update an existing saved report definition (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_request_itemAIdempotent
Update the state/stage or fields of a requested item (sc_req_item). Requires WRITE_ENABLED=true
Inputs: sys_id (required), stage, state, fields.
update_scheduled_jobAIdempotent
Update a scheduled job (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_scoped_appAIdempotent
Update an existing scoped application (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_script_includeAIdempotent
Update a script include (requires SCRIPTING_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_scrum_taskAIdempotent
Update a scrum task (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_security_incidentAIdempotent
Update a security incident record (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_sla_definitionAIdempotent
Update an SLA/OLA definition (contract_sla). Requires WRITE_ENABLED=true
Inputs: fields (required), sys_id (required).
update_storyBIdempotent
Update an agile story (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_taskAIdempotent
Update fields on a task record (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_ui_actionAIdempotent
Update an existing UI Action (requires SCRIPTING_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_uib_componentCIdempotent
Update a UI Builder component. [Scripting]
Inputs: sys_id (required), label, description.
update_uib_pageCIdempotent
Update an existing UI Builder page (title and/or route path). [Write]
Inputs: sys_id (required), path, title, layout.
update_userAIdempotent
Update a user account (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_va_topicAIdempotent
Update a Virtual Agent topic properties. [Write]
Inputs: fields (required), sys_id (required).
update_vulnerabilityAIdempotent
Update a vulnerability entry (state, risk acceptance notes, remediation date) (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
upload_attachmentA
Attach a file to a ServiceNow record (requires WRITE_ENABLED=true). Provide ONE of: file_path (a file on the machine running NowAIKit, local server only), source_url (the server fetches it), or content_base64 (small files only). file_path and source_url never pass the file through this tool call, so prefer them for anything over ~20KB: a model can only write a limited amount of text in a single call. Returns sha256 and size_bytes of what was sent so you can confirm the attachment is intact.
Inputs: table (required), record_sys_id (required), file_name, file_path, +4 more.
validate_artifactBRead-only
Validate an artifact for best practices, security issues, and performance concerns
Inputs: table (required), sys_id (required).
validate_deploymentARead-only
Pre-validate an update set or app before deployment — check for conflicts and missing dependencies
Inputs: app_sys_id, update_set_sys_id.
validate_propertyARead-only
Validate a property value against its declared type constraints without saving
Inputs: name (required), value (required).
validate_queryARead-only
Lint-check a ServiceNow encoded query BEFORE running it: validates javascript: expressions against the safe function allowlist, length limits, and common mistakes (e.g. using = instead of ^, raw spaces). Returns { valid, issues, suggestions }.
Inputs: query (required).
visualize_aggregateARead-only
Build a real-time chart of ServiceNow records grouped by a field (e.g. incidents by priority, cases by state). Returns chart-ready data, a Teams Adaptive Card (Chart.*) to drop into a Copilot Studio "Send an adaptive card" step, a markdown table, and a summary. Read-only.
Inputs: table (required), group_by (required), limit, query, +2 more.
visualize_trendARead-only
Build a real-time trend line of ServiceNow record counts over time (e.g. incidents opened per day). Returns chart-ready series, a Teams Adaptive Card line chart, a markdown table, and a summary. Read-only.
Inputs: table (required), query, title, interval, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 558 tools
The set contains many overlapping tools: generic CRUD (query_records, get_record, create_record, update_record, delete_record) coexists with table-specific tools (get_incident, create_incident, update_incident), dynamic_* tools, fluent_sdk_query, batch_request, and multiple query/aggregation tools (run_aggregate_query, aggregate_report, trend_query, visualize_aggregate). Script execution is spread across execute_script, execute_background_script, fluent_exec, and run_fix_script. Descriptions help somewhat, but with 558 tools an agent faces frequent boundary ambiguity.
Most names are snake_case and readable, but conventions vary widely: prefix families (fluent_*, sn_mcp_*, sn_a2a_*, cmdb_*, ml_*, csm_*, hr_*), noun-first names (service_health, change_readiness, investigate_incident, ask_otto), and action-oriented names (open_record_form, send_emergency_broadcast). It is not chaotic, but it lacks a single predictable verb_noun pattern.
558 tools is an extreme over-provision for any single MCP server surface, far beyond the 3–15 well-scoped norm. Even with search_tools and lean discovery, the default surface is enormous and difficult to navigate, indicating a severe count mismatch.
The surface is extremely broad, covering ITSM, CSM, HRSD, GRC, CMDB, PA, Flow Designer, portals, mobile, AI governance, and generic table CRUD via dynamic tools. There may be niche gaps, but agents can nearly always find or construct a path for common workflows.
Maintenance
Related MCP Connectors
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
Build and run AI workflows, agents, data tables and 1000+ API integrations from any MCP client.
Security-first WordPress MCP server. 129 tools for Claude, ChatGPT, Gemini. Free on wp.org.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA comprehensive MCP server for ServiceNow that provides over 60 pre-built tools for ITSM, ITOM, and App Dev operations, enabling AI agents to manage incidents, changes, users, service catalog, and projects through a unified interface.6MIT
- AlicenseNot gradedqualityDmaintenanceEnterprise-grade MCP server providing 102 production-ready tools for Jira, Confluence, and Bitbucket, enabling AI agents to manage issues, pages, repositories, and more via natural language.MIT
- AlicenseCqualityAmaintenanceEnables AI to interact with ServiceNow instances via MCP, providing 400+ tools across all modules for automation, development, and management.50018Elastic 2.0
- AlicenseNot gradedqualityAmaintenanceA metadata-driven MCP server that auto-generates 480+ tools across 160+ ServiceNow tables, with multi-instance support, natural language search, and local script development.336 npm55Apache 2.0