Role-Based Tool Packages

There are two independent ways to control how many tools your AI client sees: discovery mode (how the catalog is exposed) and packages (which subset is in scope). They work together.

Tool discovery

The full catalog is 500+ tools. Some AI clients cap how many an MCP server can advertise (Claude cloud tasks cap at 500), and loading every definition also costs context. MCP_TOOL_DISCOVERY keeps the advertised list small while keeping the whole catalog reachable on demand.

# Advertise ~13 tools; reach the full catalog on demand
MCP_TOOL_DISCOVERY=lean

Available Packages

Load a role-specific subset instead of the full set with MCP_TOOL_PACKAGE. Packages are already small, so they don't usually need lean mode.

Usage

# In .env file
MCP_TOOL_PACKAGE=service_desk

# Or as environment variable
$ MCP_TOOL_PACKAGE=service_desk node dist/server.js

// In Claude Desktop config
"env": {
  "MCP_TOOL_PACKAGE": "service_desk"
}

Package Definitions

full

All 500+ tools. Default when MCP_TOOL_PACKAGE is not set.

service_desk

Tools for IT help desk agents handling incidents, requests, and approvals.

Includes:

• All incident tools (create, get, update, resolve, close, work notes, comments)
• All approval tools (list my approvals, approve, reject)
• Knowledge search and retrieval (read-only)
• Catalog browse and order
• SLA tracking
• Task management
• Core read tools

change_coordinator

Tools for change managers reviewing and coordinating change requests.

Includes:

• All change request tools
• Approval tools
• Problem management (read + create)
• CMDB CI read tools
• Core read tools

knowledge_author

Tools for creating and publishing knowledge base content.

Includes:

• Full knowledge base tools (create, update, publish)
• Catalog read tools
• Core read tools

catalog_builder

Tools for building and managing the service catalog.

Includes:

• Full catalog tools
• User and group read tools
• Core read tools

system_administrator

Tools for system administrators managing users, groups, schedules, and security.

Includes:

• Full user and group management
• Reporting, analytics, and scheduled job management (create/update/trigger)
• CMDB health tools (cmdb_find_duplicates, cmdb_find_orphans, cmdb_find_stale, cmdb_reconcile)
• Table discovery (discover_table)
• Notifications and email log
• Attachment management (upload, list, delete)
• ACL management
• Performance Analytics and data quality checks
• OAuth applications and credential aliases
• System log
• Core read tools

platform_developer

Tools for platform developers managing scripts, automations, and security rules.

Includes:

• Full scripting tools (business rules, script includes, client scripts)
• UI Policies and UI Actions (create/update)
• Fluent Query tools (fluent_explain, fluent_init, fluent_build, fluent_validate)
• Table discovery (discover_table)
• ACL rule management
• Changeset management
• ATF testing tools
• Core read tools

Requires: SCRIPTING_ENABLED=true, ATF_ENABLED=true

portal_developer

Tools for Service Portal and UI Builder developers.

Includes:

• Full Service Portal tools (portals, pages, widgets CRUD)
• Next Experience / UI Builder apps and pages
• Portal themes
• UI Policies and UI Actions
• Client script management
• Changeset management
• Core read tools

Requires: SCRIPTING_ENABLED=true (for write tools)

integration_engineer

Tools for integration and middleware specialists.

Includes:

• REST Message configuration (create/list)
• Transform Map execution and field mapping
• Import Set management
• Event registry and event firing
• OAuth and credential alias read tools
• Changeset management
• Core read tools

Requires: WRITE_ENABLED=true, SCRIPTING_ENABLED=true (for register_event)

itom_engineer

Tools for IT operations and CMDB engineers.

Includes:

• Full CMDB tools (read + create/update with CMDB_WRITE_ENABLED)
• CMDB health tools (cmdb_find_duplicates, cmdb_find_orphans, cmdb_find_stale, cmdb_reconcile)
• Discovery and MID server tools
• Event management tools
• Service Mapping
• Core read tools

agile_manager

Tools for agile team leads managing sprints and backlogs.

Includes:

• Full agile/scrum tools (stories, epics, tasks)
• User read tools
• Core read tools

ai_developer

Tools for developers building Now Assist and AI integrations.

Includes:

• Full Now Assist tools (NLQ, AI Search, summaries, agentic playbooks)
• Now Assist Skills management (create, list, get, test)
• AI Agent tools (create, list, get agents; create agentic workflows)
• ML tools (similar incidents, auto-categorize)
• Predictive Intelligence tools
• Table discovery (discover_table)
• Knowledge read tools
• Core read tools

Requires: NOW_ASSIST_ENABLED=true, WRITE_ENABLED=true (for create/test tools)

devops_engineer

Tools for DevOps engineers managing CI/CD pipelines and deployment tracking.

Includes:

• DevOps pipeline and deployment tools (list, get, create, track, insights)
• Update Set management (create, switch, complete, preview, export)
• Change request tools (create, get, list)
• Core read tools

itam_analyst

Tools for IT Asset Management analysts tracking hardware and software assets.

Includes:

• Asset lifecycle tools (list, get, create, update, retire)
• Software license compliance tools
• Asset contract management
• Core read tools

Permission Requirements by Package