Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
WRITE_ENABLEDNoEnable write operations (create/update). Set to 'true' to enable.false
MCP_TOOL_PACKAGENoRole-based tool package: 'full', 'service_desk', 'change_coordinator', 'knowledge_author', 'catalog_builder', 'system_administrator', 'platform_developer', 'portal_developer', 'integration_engineer', 'itom_engineer', 'agile_manager', 'ai_developer'full
SCRIPTING_ENABLEDNoEnable scripting operations. Set to 'true' to enable.false
CMDB_WRITE_ENABLEDNoEnable CMDB write operations. Set to 'true' to enable.false
NOW_ASSIST_ENABLEDNoEnable Now Assist operations. Set to 'true' to enable.false
SN_INSTANCES_CONFIGNoPath to a JSON file containing multiple instance configurations (alternative to single instance env vars)
SERVICENOW_AUTH_METHODNoAuthentication method: 'basic' or 'oauth'basic
SERVICENOW_INSTANCE_URLNoThe URL of your ServiceNow instance (e.g., https://yourinstance.service-now.com)
SERVICENOW_BASIC_PASSWORDNoPassword for basic authentication
SERVICENOW_BASIC_USERNAMENoUsername for basic authentication
SERVICENOW_OAUTH_PASSWORDNoOAuth password (for password grant type)
SERVICENOW_OAUTH_USERNAMENoOAuth username (for password grant type)
SERVICENOW_OAUTH_CLIENT_IDNoOAuth client ID
SERVICENOW_OAUTH_CLIENT_SECRETNoOAuth client secret

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{}
prompts
{}
resources
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_toolsA

Search the full NowAIKit tool catalog (400+ 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.

query_recordsB

Query ServiceNow records with filtering, field selection, pagination, and sorting

get_table_schemaA

Get the structure and field information for a ServiceNow table

get_recordB

Retrieve complete details of a specific record by sys_id

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.

update_recordA

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.

delete_recordA

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.

validate_queryA

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 }.

get_userA

Look up user details by email or username

get_groupA

Find assignment group details by name or sys_id

search_cmdb_ciC

Search for configuration items (CIs) in the CMDB

get_cmdb_ciC

Get complete information about a specific configuration item

list_relationshipsA

Show parent and child relationships for a CI

list_discovery_schedulesA

List discovery schedules and their run status

list_mid_serversB

List MID servers and verify they are healthy

list_active_eventsC

Monitor critical infrastructure events

cmdb_health_dashboardA

Get CMDB data quality metrics (completeness of server and network CI data)

service_mapping_summaryB

View service dependencies and related CIs for impact analysis

natural_language_searchB

Search ServiceNow using plain English

natural_language_updateB

Update a record using natural language (requires WRITE_ENABLED=true)

list_instancesA

List all configured ServiceNow instances (multi-instance / multi-customer support)

switch_instanceB

Switch the active ServiceNow instance for this session

get_current_instanceA

Get the currently active ServiceNow instance name and URL

create_ci_relationshipB

[Write] Create a relationship between two CMDB Configuration Items

cmdb_impact_analysisA

Analyze the downstream impact of a Configuration Item change or outage

run_discovery_scanB

[Write] Trigger a ServiceNow Discovery scan for network/infrastructure

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.

rollback_changesA

Delete a set of previously-created records, e.g. the rollback_token returned by bulk_create_records. Requires WRITE_ENABLED=true.

compare_instancesA

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.

create_incidentA

Create a new incident record (requires WRITE_ENABLED=true)

get_incidentA

Get full details of an incident by number (e.g. INC0012345) or sys_id

update_incidentA

Update fields on an existing incident (requires WRITE_ENABLED=true)

resolve_incidentB

Resolve an incident with resolution code and notes (requires WRITE_ENABLED=true)

close_incidentA

Close a resolved incident (requires WRITE_ENABLED=true)

add_work_noteA

Add an internal work note to any ITSM record (requires WRITE_ENABLED=true)

add_commentA

Add a customer-visible comment to any ITSM record (requires WRITE_ENABLED=true)

create_problemB

Create a new problem record (requires WRITE_ENABLED=true)

get_problemA

Get full details of a problem by number (PRB...) or sys_id

update_problemA

Update fields on an existing problem (requires WRITE_ENABLED=true)

resolve_problemA

Resolve a problem with root cause and resolution notes (requires WRITE_ENABLED=true)

create_change_requestB

Create a new change request (requires WRITE_ENABLED=true)

get_change_requestA

Get full details of a change request by number (CHG...) or sys_id

update_change_requestB

Update fields on a change request (requires WRITE_ENABLED=true)

list_change_requestsB

List change requests with optional filtering by state or query

submit_change_for_approvalA

Move a change request to "Requested" state for approval (requires WRITE_ENABLED=true)

close_change_requestA

Close a change request with close code and notes (requires WRITE_ENABLED=true)

schedule_cab_meetingB

[Write] Schedule a Change Advisory Board (CAB) meeting

get_taskA

Get details of any task record by number or sys_id

update_taskB

Update fields on a task record (requires WRITE_ENABLED=true)

list_my_tasksA

List tasks assigned to the currently configured user

complete_taskA

Mark a task as complete (requires WRITE_ENABLED=true)

list_knowledge_basesA

List all knowledge bases available in the instance

search_knowledgeB

Search knowledge base articles by keyword

get_knowledge_articleA

Get the full content of a knowledge article by number (KB...) or sys_id

create_knowledge_articleC

Create a new knowledge article (requires WRITE_ENABLED=true)

update_knowledge_articleA

Update a knowledge article (requires WRITE_ENABLED=true)

publish_knowledge_articleB

Publish a draft knowledge article (requires WRITE_ENABLED=true)

retire_knowledge_articleB

[Write] Retire a knowledge article (mark as outdated)

list_catalog_itemsB

List available service catalog items

search_catalogA

Search the service catalog for items matching a keyword

get_catalog_itemA

Get full details of a catalog item including its variables

create_catalog_itemB

Create a new service catalog item (requires WRITE_ENABLED=true)

update_catalog_itemA

Update an existing catalog item (requires WRITE_ENABLED=true)

order_catalog_itemA

Order a service catalog item (requires WRITE_ENABLED=true)

create_approval_ruleA

Create an approval rule that automatically generates approval requests when a record matches given conditions (requires WRITE_ENABLED=true). Uses the sysapproval_rule table.

get_my_approvalsA

List approvals pending for the currently configured user

list_approvalsB

List approval requests with optional filters

approve_requestA

Approve a pending approval request (requires WRITE_ENABLED=true)

reject_requestA

Reject a pending approval request (requires WRITE_ENABLED=true)

get_sla_detailsA

Get SLA breach status for a specific task or incident

list_active_slasC

List active SLA records with optional filters

create_catalog_variableA

[Write] Add a form variable to a service catalog item

create_catalog_ui_policyA

[Write] Create a UI policy for a catalog item form

list_usersB

List users with optional search filter

create_userA

Create a new user account (requires WRITE_ENABLED=true)

update_userA

Update a user account (requires WRITE_ENABLED=true)

list_groupsC

List groups with optional search filter

create_groupA

Create a new assignment group (requires WRITE_ENABLED=true)

update_groupA

Update a group (requires WRITE_ENABLED=true)

add_user_to_groupA

Add a user to a group (requires WRITE_ENABLED=true)

remove_user_from_groupA

Remove a user from a group (requires WRITE_ENABLED=true)

list_reportsB

List saved reports in the instance (latest release: /api/now/reporting)

get_reportA

Get the definition and metadata of a saved report

run_aggregate_queryB

Run a grouped aggregate (COUNT, SUM, AVG) query on any table (latest release: /api/now/stats/{table})

trend_queryA

Get time-bucketed trend data for a table (useful for monthly/weekly trend charts)

get_performance_analyticsA

Get Performance Analytics widget data (requires PA plugin; latest release: /api/now/pa/widget/{sys_id})

export_report_dataA

Export raw table data as structured JSON for use in external reports

get_sys_logB

Retrieve system log entries for debugging or auditing

list_scheduled_jobsA

List scheduled jobs and their run schedules

get_scheduled_jobA

Get full details of a scheduled job by sys_id or name

create_scheduled_jobA

Create a new scheduled script execution job (requires WRITE_ENABLED=true)

update_scheduled_jobA

Update a scheduled job (requires WRITE_ENABLED=true)

trigger_scheduled_jobA

Immediately execute a scheduled job on-demand (requires WRITE_ENABLED=true)

create_reportA

Create a new saved report on any table (requires WRITE_ENABLED=true)

update_reportA

Update an existing saved report definition (requires WRITE_ENABLED=true)

list_job_run_historyB

List recent run history for scheduled jobs (success/failure log)

create_scheduled_reportC

[Write] Schedule a report for recurring email delivery

create_kpiC

[Write] Create a Key Performance Indicator from ServiceNow data

generate_reportA

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.

list_atf_suitesA

List ATF test suites in the instance

Prompts

Interactive templates invoked by user choice

NameDescription
morning-standupDaily standup briefing — P1/P2 incidents, SLA breaches, changes due today
my-ticketsAll open tasks, incidents, and requests assigned to me
p1-alertsActive P1 incidents with time open and assignee
my-changesMy pending change requests and their approval status
knowledge-searchSearch the knowledge base
create-incidentGuided incident creation — asks for details then creates the record
sla-breachesRecords currently breaching or about to breach SLA
ci-healthCMDB health check for a named CI
run-atfTrigger an ATF test suite and report results
switch-instanceSwitch to a different ServiceNow instance for this session
deploy-updatesetPreview and commit an update set
scan-healthComplete instance health assessment — plugins, scheduled jobs, logs, quotas, system diagnostics
scan-securityComprehensive security scan — ACLs, roles, scripts, APIs, compliance across ALL artifact types
scan-debtFind dead code, unused scripts, duplicate logic, stale configurations across ALL artifact types
scan-upgradeCheck deprecated APIs, incompatible patterns, and plugin conflicts before upgrading
scan-cmdbCMDB health — stale CIs, broken relationships, data quality, orphan detection, class compliance
scan-automationAutomation conflict detection — overlapping business rules and flows, circular triggers, execution order
review-codeDeep code review — security, performance, best practices, upgrade safety across all artifact types
review-aclsACL coverage analysis — missing ACLs, field-level gaps, overly permissive rules, conflicts
review-scriptsBulk script scan — injection, performance antipatterns, deprecated APIs, hardcoded sys_ids
review-flowsFlow Designer audit — error handling, performance, dead paths, async issues, security, compliance
build-business-ruleGuided business rule creation — understand, check existing, generate, review, create, test
build-client-scriptGuided client script creation — onChange, onLoad, onSubmit, onCellEdit with best practices
build-test-planGenerate ATF test plan for any artifact type — BRs, SIs, Client Scripts, Flows, ACLs, Catalog
build-appComplete 7-phase scoped application builder — from data model to packaging
build-flowFlow Designer creation — triggers, actions, error handling, subflows, testing
build-portalService Portal widget builder — server, client, HTML, CSS with architectural guidance
build-uibUI Builder / Next Experience component builder — Seismic, NEDS, macroponents
build-catalogEnd-to-end catalog item builder — variables, approval, fulfillment, client scripts
build-rest-apiScripted REST API builder — resources, auth, error handling, versioning, documentation
ops-triageP1/P2 incident triage — fetch details, assess CMDB impact, check SLAs, search KB, suggest resolution
ops-deploySafe deployment pipeline — validate, preview, create change, ATF, commit, rollback plan
ops-riskChange risk scoring, conflict detection, CAB preparation, and rollback planning
docs-appAuto-generate comprehensive application documentation — tables, scripts, flows, ACLs, catalog
docs-releaseGenerate release notes from update set — categorize changes, highlight breaking changes
docs-runbookOperational runbook — incident response, health checks, escalation, recovery procedures
docs-scriptDetailed script documentation — JSDoc, explanation, usage examples, dependencies, security
build-atf-suiteAI-generates runnable ATF test suites from business rules, script includes, flows, or any artifact

Resources

Contextual data attached and managed by the client

NameDescription
my-incidentsOpen incidents currently assigned to me
open-changesChange requests pending approval or scheduled this week
sla-breachesRecords currently breaching or about to breach SLA
instance:infoCurrent active ServiceNow instance metadata
ci:<name>CMDB Configuration Item by name (e.g. @ci:web-prod-01)
kb:<title>Knowledge Base article by title (e.g. @kb:VPN-setup)
query-syntaxServiceNow encoded query syntax reference — operators, patterns, date functions, anti-patterns

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/aartiq/nowaikit'

If you have feedback or need assistance with the MCP directory API, please join our Discord server