Skip to content

ServiceNow MCP - Tool Inventory

AUTO-GENERATED by scripts/regenerate_tool_inventory.py. Do not edit by hand.

Registered tools in the live registry: 70 Packaged tool count in full: 56 Registered but currently unpackaged tools: 11

list_tool_packages is injected at runtime into every enabled package except none. It is documented below, but package counts in this file reflect the YAML-defined tool surface.

Package Summary

Package Tools Description
none 0 Disabled profile for intentionally turning tools off.
core 12 Minimal read-only essentials for quick health/schema/table work.
standard 30 Default read-only package across incidents, changes, portal, logs, and source analysis.
service_desk 32 standard plus incident and change write workflows for operational support.
portal_developer 45 standard plus portal, changeset, script include, and local-sync delivery workflows.
platform_developer 42 standard plus workflow, Flow Designer, UI policy, incident/change, and script writes.
full 56 Broadest packaged surface: all manage_* workflows plus advanced operations.

Runtime-Injected Helpers

Tool R/W Description Packages
list_tool_packages R Lists the available tool packages and the currently active one. core, standard, service_desk, portal_developer, platform_developer, full
list_instances R Lists configured aliases for read-only data comparison mode. runtime comparison helper
compare_instances R Read-only record comparison across configured aliases; not a write-routing mechanism. runtime comparison helper

Registered but Unpackaged Tools

These tools are registered in code but intentionally excluded from the packaged YAML surfaces. They remain reachable for custom builds, tests, or future packaging decisions.

create_category, create_knowledge_base, get_developer_daily_summary, get_repo_file_last_modifier, get_repo_recent_commits, get_repo_working_tree_status, get_uncommitted_changes, manage_epic, manage_project, manage_scrum_task, manage_story

Tools by Module

The R/W column is the tool's full capability when unrestricted. A package shown as pkg (actions…) exposes ONLY those actions of that tool — e.g. manage_script_include is registered R/W but the read-only packages (core, standard) expose it as standard (get, list). Packages listed without parentheses expose the tool at its full R/W capability.

Attachment Tools (1)

Tool R/W Description Packages
download_attachment R Download ServiceNow attachment file(s) to disk by attachment_sys_id, or table+record. Read from saved_path. standard, portal_developer, platform_developer, service_desk, full

Audit Tools (1)

Tool R/W Description Packages
audit_pending_changes R Audit pending update set changes — inventory by type, risk patterns, clones, and cross-refs. full

Browser Debug Tools (3)

Tool R/W Description Packages
act_in_debug_window W Drive the open debug window: click, fill, select, wait, eval, impersonate. Reports what steps caused. portal_developer
inspect_debug_window R Read the shared debug window: console errors, XHR, duplicates, screenshot, CSS, JS expression. Never opens one. portal_developer
open_debug_window R Open a visible browser window on the user's screen for shared debugging. Reuses an open one. portal_developer

Catalog Tools (1)

Tool R/W Description Packages
manage_catalog R/W Catalog category/item/variable CRUD (tables: sc_category, sc_cat_item, item_option_new). portal_developer, service_desk (get_item, list_categories, list_item_variables, list_items), full

Change Tools (4)

Tool R/W Description Packages
approve_change W Approve a change's approval record (by approver_id); advance the change_request (default: implement). full
manage_change R/W Get/create/update a change request or add a change task (table: change_request). platform_developer, full
reject_change W Reject a change's approval record (by approver_id) with reason; advance the change_request (default: canceled). full
submit_change_for_approval W Transition a change request to assess state and create an approval record. Requires change_id. platform_developer, full

Changeset Tools (1)

Tool R/W Description Packages
manage_changeset R/W Get/create/update/commit/publish/add_file on an update set (table: sys_update_set). portal_developer, platform_developer, full

Epic Tools (1)

Tool R/W Description Packages
manage_epic R/W Epic CRUD (table: rm_epic). list skips confirm.

Flow Tools (1)

Tool R/W Description Packages
manage_flow_designer R/W Flow Designer read/edit: action inputs, trigger/branch conditions, add_branch (clone a branch). Publish via action='p... core (list), standard (get_action_source, get_detail, get_executions, list), portal_developer, platform_developer, service_desk (get_action_source, get_detail, get_executions, list), full

Incident Management (1)

Tool R/W Description Packages
manage_incident R/W Get/create/update/comment/resolve an incident (table: incident). One call, no schema lookup needed. platform_developer, service_desk, full

Knowledge Base (3)

Tool R/W Description Packages
create_category W Create a KB category under a knowledge base. Requires kb_id and label.
create_knowledge_base W Create a knowledge base (kb_knowledge_base). Requires title. Returns sys_id.
manage_kb_article R/W Create/update/publish a knowledge article (table: kb_knowledge). full

Local Graph Tools (1)

Tool R/W Description Packages
query_local_graph R Offline dependency/impact answers from audit graph files (0 API). uses used_by

Logs (1)

Tool R/W Description Packages
get_logs R Query ServiceNow logs. log_type: system/journal/transaction/background. Max 20 rows. core, standard, portal_developer, platform_developer, service_desk, full

Performance Tools (1)

Tool R/W Description Packages
analyze_widget_performance R Analyze widget performance — code patterns, transaction logs, provider usage. Returns findings with severity. standard, portal_developer, platform_developer, service_desk, full

Portal CRUD (3)

Tool R/W Description Packages
manage_portal_component W Create portal components; or edit ANY code record by sys_id — BR, notification, SI, ACL, UI, etc. action=update_code. portal_developer, platform_developer, full
manage_portal_layout W Portal layout: page CRUD + container/row/column + widget instance placement. portal_developer, platform_developer, full
scaffold_page W Create a complete portal page with layout (container/rows/columns) and widget placements in one call. Scope is required. portal_developer, platform_developer, full

Portal Dev Tools (3)

Tool R/W Description Packages
get_developer_changes R List developer's recent changes across portal tables. Metadata only, use count_only first. standard, portal_developer, platform_developer, service_desk, full
get_developer_daily_summary R Generate developer daily work summary. Supports jira/plain/structured output formats.
get_uncommitted_changes R List uncommitted update set entries for a developer. Returns entry type and target. Use count_only=true first.

Portal Management (9)

Tool R/W Description Packages
analyze_portal_component_update R Analyze a proposed portal component edit and return bounded risk and field-change summaries portal_developer, full
detect_angular_implicit_globals R Detect undeclared variable assignments in Angular provider scripts that cause runtime 'not defined' errors. portal_developer, full
download_portal_sources R Targeted portal widgets/providers. Whole app: download_app_sources. widget_ids=one widget. standard, portal_developer, platform_developer, service_desk, full
get_portal_component_code R Fetch widget/provider/SI fields. Returns full body by default. Never chunk for analysis. standard, portal_developer, platform_developer, service_desk, full
get_widget_bundle R Fetch full widget bundle (HTML, scripts, providers, CSS/JS dependencies) in one call. Analysis starting point. standard, portal_developer, platform_developer, service_desk, full
preview_portal_component_update R Preview bounded before/after snippets and diff for a proposed portal component edit portal_developer, full
route_portal_component_edit R Route a portal edit instruction to the right analyze/preview/apply tool. portal_developer, full
search_portal_regex_matches R True regex over portal code (widget/provider/SI), offsets+context. Server-table keyword search: search_server_code. standard, portal_developer, platform_developer, service_desk, full
trace_portal_route_targets R Map widget→provider→route relationships. Metadata only, no script bodies. standard, portal_developer, platform_developer, service_desk, full

Portal Management Tools (3)

Tool R/W Description Packages
get_page R Get or list portal pages by URL path, title, or sys_id. Returns layout tree with widget placements. core, standard, portal_developer, platform_developer, service_desk, full
get_portal R Get or list Service Portals by name, URL suffix, or sys_id. Returns config, homepage, theme, and pages. full
get_widget_instance R Get widget instance placement on a page. Returns column, order, and config. Filter by page or widget. standard, portal_developer, platform_developer, service_desk, full

Project Tools (1)

Tool R/W Description Packages
manage_project R/W Project CRUD (table: pm_project). list skips confirm.

Repository (4)

Tool R/W Description Packages
get_repo_change_report R Combined git report: working tree status + recent commits + per-file last modifier in one call. full
get_repo_file_last_modifier R Lookup per-file last modifier and commit metadata with optional uncommitted status
get_repo_recent_commits R List recent commits with author and optional changed file lists
get_repo_working_tree_status R Inspect working tree status including staged, unstaged, and untracked files

Script Include (1)

Tool R/W Description Packages
manage_script_include R/W List/get/create/update/delete/execute a script include (table: sys_script_include). core (get, list), standard (get, list), portal_developer, platform_developer, service_desk (get, list), full

Scripted Rest Tools (1)

Tool R/W Description Packages
manage_scripted_rest W CRUD Scripted REST services + resources (sys_ws_definition/sys_ws_operation). Use list/get to find sys_ids. standard (get, list), portal_developer, platform_developer (get, list), service_desk (get, list), full

Scrum Task Tools (1)

Tool R/W Description Packages
manage_scrum_task R/W Scrum task CRUD (table: rm_scrum_task). list skips confirm.

Session Context Tools (1)

Tool R/W Description Packages
manage_session_context W Get/switch current application + update set (browser auth). set_* verifies via read-back. portal_developer, platform_developer, full

Sn Api (7)

Tool R/W Description Packages
sn_aggregate R Run COUNT/SUM/AVG/MIN/MAX on any table with optional group_by. Returns stats without fetching records. core, standard, portal_developer, platform_developer, service_desk, full
sn_discover R Find tables by name or label keyword. Returns table name, label, scope, and parent class. core, standard, portal_developer, platform_developer, service_desk, full
sn_health R Check ServiceNow API connectivity, auth status, Chromium install state (browser auth), and MCP server version. core, standard, portal_developer, platform_developer, service_desk, full
sn_query R Generic table query — last resort. Prefer domain tools: search_server_code, manage_workflow, manage_flow_designer. core, standard, portal_developer, platform_developer, service_desk, full
sn_resolve_url R Parse a ServiceNow URL → table, sys_id, scope, suggested next tool. Read-only. core, standard, portal_developer, platform_developer, service_desk, full
sn_schema R Fetch field names, types, labels, and constraints from sys_dictionary for a given table. core, standard, portal_developer, platform_developer, service_desk, full
sn_write W LAST RESORT CRUD (no dedicated tool). Prefer manage_/update_. ACL/user/group/scope blocked. confirm='approve'. full

Source Analysis (6)

Tool R/W Description Packages
download_app_sources R FULL/all source of an app scope to disk (all groups+deps). scope REQUIRED — ask user. Step 1, not portal. standard, portal_developer, platform_developer, service_desk, full
download_server_sources R Targeted server-side source families (SIs/BRs/UI/api/security/admin). Whole app: download_app_sources. platform_developer, full
download_table_schema R Download sys_dictionary field defs. Specify tables or auto-detect from local sources. platform_developer, full
extract_table_dependencies R GlideRecord table dependency graph from server scripts (SI/BR/widgets). Pass widget_id for one widget. standard, portal_developer, platform_developer, service_desk, full
get_metadata_source R Get one source record (SI/BR/widget) by name/sys_id. Returns body; 'complete' flags if truncated preview. standard, portal_developer, platform_developer, service_desk, full
search_server_code R Fast keyword search across 22 server-side code types (SI/BR/ACL). Portal regex+snippets: search_portal_regex_matches. core, standard, portal_developer, platform_developer, service_desk, full

Source Audit Tools (1)

Tool R/W Description Packages
audit_local_sources R Analyze downloaded sources locally (no API). Generates cross-ref graph, dead code, HTML report. standard, portal_developer, platform_developer, service_desk, full

Story Tools (1)

Tool R/W Description Packages
manage_story R/W Story CRUD + dependency ops (rm_story/m2m_story_dependencies). list/list_dependencies skip confirm.

Sync Tools (2)

Tool R/W Description Packages
diff_local_component R Diff local edits vs remote (or compare_to root); verdict=True status-only, refresh=True fast-forwards. standard, portal_developer, platform_developer, service_desk, full
update_remote_from_local W Push one local edit back to ServiceNow (diff_local_component first). Targeted refresh, not bulk dev→test promotion. portal_developer, platform_developer, full

UI Policy (1)

Tool R/W Description Packages
manage_ui_policy W UI Policy create + add field action (tables: sys_ui_policy / sys_ui_policy_action). portal_developer, platform_developer, full

User Tools (2)

Tool R/W Description Packages
manage_group R/W Group CRUD + membership ops (table: sys_user_group). list skips confirm. full
manage_user R/W User CRUD + lookup (table: sys_user). Read actions skip confirm. full

Widget Dependency Tools (1)

Tool R/W Description Packages
manage_widget_dependency R/W CRUD + link/unlink for widget Angular providers & CSS/JS dependencies. Use action=list first for sys_ids. standard (get, list), portal_developer, platform_developer (get, list), service_desk (get, list), full

Workflow (1)

Tool R/W Description Packages
manage_workflow R/W LEGACY Workflow engine ONLY (wf_workflow/wf_activity). Most flows are Flow Designer -> use manage_flow_designer. core (get_activities, list), standard (get_activities, list), portal_developer, platform_developer, service_desk (get_activities, list), full

Xml Export Tools (1)

Tool R/W Description Packages
export_record_xml R Export records as importable XML to disk (current sys_update_version). Read saved_path. standard, portal_developer, platform_developer, service_desk, full