---

name: mcp-tool-discovery description: This skill should be used when the user asks about "available tools", "what tools", "how to find tools", "tool search", "MCP servers", "list tools", "discover tools", "which tools", or needs guidance on discovering and using Snow-Flow MCP tools. license: Apache-2.0 compatibility: Designed for Snow-Code and ServiceNow development metadata: author: groeimetai version: "1.0.0" category: platform tools:

• tool_search

---

MCP Tool Discovery Guide

Snow-Flow provides 400+ tools via MCP (Model Context Protocol) servers. Tools are lazy-loaded to save tokens - use tool_search to discover them.

Quick Start

Copy// Find tools for a specific task
tool_search({ query: "incident" })      // ServiceNow incidents
tool_search({ query: "widget" })        // Widget development
tool_search({ query: "update set" })    // Update Set management
tool_search({ query: "cmdb" })          // CMDB operations

Tool Categories

ServiceNow Core Operations

ServiceNow Development

ServiceNow Platform

Activity & Instance

Enterprise (if enabled)

Always-Available Tools

These tools are loaded by default (no discovery needed):

Copy// Activity tracking
activity_start({ source, storyTitle, storyType, ... })
activity_update({ activityId, status, summary })
activity_complete({ activityId, summary })
activity_add_artifact({ activityId, artifactType, ... })

// Core tool discovery
tool_search({ query, enable: true })

How tool_search Works

1. Search - Finds tools matching your query
2. Enable - Automatically enables found tools for your session
3. Use - Call the discovered tool by name

Copy// Step 1: Search
tool_search({ query: "jira" })
// Returns: jira_search_issues, jira_get_issue, jira_create_issue, ...

// Step 2: Call discovered tool
jira_search_issues({ jql: "project = PROJ AND status = Open" })

Search Tips

Be Specific

Copy// Too broad - may not find what you need
tool_search({ query: "github" })  // Returns 20+ tools

// More specific - finds exactly what you need
tool_search({ query: "github content" })      // File content tools
tool_search({ query: "github repository" })   // Repo info tools
tool_search({ query: "github pull request" }) // PR tools

Search by Action

Copytool_search({ query: "create incident" })
tool_search({ query: "update widget" })
tool_search({ query: "query cmdb" })
tool_search({ query: "deploy business rule" })

Search by Table

Copytool_search({ query: "sys_script_include" })
tool_search({ query: "sp_widget" })
tool_search({ query: "sysevent_email_action" })

Tool Naming Patterns

Tools follow consistent naming patterns:

MCP Server Categories

Snow-Flow includes specialized MCP servers:

Best Practices

1. Discover Before Using - Always use tool_search first
2. Be Specific - Narrow queries find better matches
3. Check Results - Review tool descriptions before calling
4. Enable by Default - enable: true is the default
5. Silent Discovery - Don't tell users you're discovering tools

Troubleshooting

Example Workflows

Finding Incident Tools

Copy// Discover
tool_search({ query: "incident" })

// Use discovered tools
snow_query_incidents({ filters: { active: true, priority: 1 } })
snow_create_incident({ short_description: "...", caller_id: "..." })

Finding Widget Tools

Copy// Discover
tool_search({ query: "widget" })

// Use discovered tools
snow_find_artifact({ type: "widget", query: "incident" })
snow_widget_pull({ widget_name: "incident-dashboard", local_path: "./widgets" })

Finding Enterprise Tools

Copy// Discover Jira tools
tool_search({ query: "jira" })

// Use discovered tools
jira_search_issues({ jql: "project = SNOW AND status = Open" })
jira_transition_issue({ issueKey: "SNOW-123", transition: "In Progress" })