Lookup Application or Plugin
lookup_appSearch for ServiceNow applications and platform plugins by name, scope namespace, or plugin ID. Returns sys_id, name, scope, version, active status, and type for each match.
Instructions
Search for ServiceNow applications (scoped apps) and platform plugins by name, scope namespace, or plugin ID. Returns sys_id, name, scope, version, active status, and type for each match.
ServiceNow uses a hierarchical table structure for packages:
sys_scope: All scoped applications (base table)
sys_app: Custom applications in development on this instance
sys_store_app: Applications installed from the ServiceNow Store or company app repo
sys_plugins: Platform plugins
Key use cases:
Find an application's sys_id to pass as the
scopeparameter to execute_script (to run scripts within that application's scope)Check whether a specific app or plugin is installed/active on the instance
Look up version, scope namespace, and vendor info for any application or plugin
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| instance | No | The ServiceNow instance auth alias (e.g., "myinstance", "prod"). If not provided, falls back to the SN_AUTH_ALIAS environment variable. | |
| search_term | Yes | Name, scope namespace (e.g., "x_acme_my_app", "sn_vul"), or plugin ID (e.g., "com.snc.vulnerability_response") to search for. Case-insensitive partial matching (contains). | |
| type | No | Filter search scope. "app" searches scoped applications only (sys_scope table which includes both custom apps and store apps), "plugin" searches platform plugins only (sys_plugins table), "all" searches both. Default is "all". | all |
| active_only | No | When true, only returns active/installed applications and plugins. Default is false (returns all matches regardless of active status). |