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: 65 Packaged tool count in full: 54 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 28 Default read-only package across incidents, changes, portal, logs, and source analysis.
service_desk 30 standard plus incident and change write workflows for operational support.
portal_developer 40 standard plus portal, changeset, script include, and local-sync delivery workflows.
platform_developer 40 standard plus workflow, Flow Designer, UI policy, incident/change, and script writes.
full 54 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

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 (targets approver_id); advance change_request (default implement, override change_... 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 (targets approver_id) with reason; advance change_request (default canceled, overri... 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/inspect. Edits LIMITED to action inputs + trigger/branch conditions; no structural changes (use UI). 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 code-record fields by sys_id (widget/SI/UI/Scripted REST/ACL). 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 Regex search across widget/SI/provider sources. Output: minimal compact
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

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 generic CRUD — only for tables with NO dedicated tool. Prefer a manage_/update_ domain tool first (they... 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 a single source record (SI, BR, widget, etc.) by name or sys_id. Returns metadata + truncated script body. standard, portal_developer, platform_developer, service_desk, full
search_server_code R Search across 22 server-side source types (SI, BR, widget, ACL, etc.) by keyword/regex. Returns matching snippets. 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. Run before update_remote_from_local (review) or re-download (freshness). standard, portal_developer, platform_developer, service_desk, full
update_remote_from_local W Push local edits to ServiceNow. Run diff_local_component first to review. 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 workflows (wf_workflow/wf_activity). For modern Flow Designer use manage_flow_designer. core (get_activities, list), standard (get_activities, list), portal_developer, platform_developer, service_desk (get_activities, list), full