mcp-tool-discovery
Original：🇺🇸 English
Translated
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.
6installs
Sourcegroeimetai/snow-flow
Added on
NPX Install
npx skill4agent add groeimetai/snow-flow mcp-tool-discoveryTags
Translated version includes tags in frontmatterSKILL.md Content
View Translation Comparison →MCP Tool Discovery Guide
Snow-Flow provides 400+ tools via MCP (Model Context Protocol) servers. Tools are lazy-loaded to save tokens - use to discover them.
tool_searchQuick Start
javascript
// 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 operationsTool Categories
ServiceNow Core Operations
| Query | Tools Found |
|---|---|
| Incident CRUD, metrics, SLA |
| Change requests, CAB, risk |
| Problem management, known errors |
| CI search, relationships, discovery |
| User/group queries |
| Universal table queries |
ServiceNow Development
| Query | Tools Found |
|---|---|
| Widget create/update/sync |
| BR creation and management |
| Reusable scripts |
| Client-side scripts |
| Form policies |
| Buttons and links |
| Update Set lifecycle |
| Artifact deployment |
ServiceNow Platform
| Query | Tools Found |
|---|---|
| Flow/subflow creation |
| Workspace builder |
| Service catalog items |
| Knowledge articles |
| Email notifications |
| Scheduled scripts |
| REST API integration |
| Import sets, transform maps |
Activity & Instance
| Query | Tools Found |
|---|---|
| Activity tracking (always available) |
| Instance URL and config |
| System properties |
| System logs |
Enterprise (if enabled)
| Query | Tools Found |
|---|---|
| Jira issues, transitions, comments |
| Work items, boards, pipelines |
| Pages, spaces, search |
| Issues, PRs, workflows, releases |
| Issues, MRs, pipelines |
Always-Available Tools
These tools are loaded by default (no discovery needed):
javascript
// 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
- Search - Finds tools matching your query
- Enable - Automatically enables found tools for your session
- Use - Call the discovered tool by name
javascript
// 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
javascript
// 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 toolsSearch by Action
javascript
tool_search({ query: "create incident" })
tool_search({ query: "update widget" })
tool_search({ query: "query cmdb" })
tool_search({ query: "deploy business rule" })Search by Table
javascript
tool_search({ query: "sys_script_include" })
tool_search({ query: "sp_widget" })
tool_search({ query: "sysevent_email_action" })Tool Naming Patterns
Tools follow consistent naming patterns:
| Pattern | Example | Purpose |
|---|---|---|
| | ServiceNow operations |
| | Artifact creation |
| | Update operations |
| | Jira integration |
| | Azure DevOps |
| | Confluence |
| | GitHub |
| | GitLab |
MCP Server Categories
Snow-Flow includes specialized MCP servers:
| Server | Purpose | Example Tools |
|---|---|---|
| ServiceNow Unified | Core ServiceNow ops | Query, CRUD, scripts |
| ServiceNow Development | Artifact management | Deploy, widget sync |
| ServiceNow Automation | Script execution | Background scripts |
| ServiceNow ITSM | IT Service Management | Incidents, changes |
| ServiceNow Platform | Platform features | Flows, workspaces |
| Enterprise | External integrations | Jira, Azure, GitHub |
Best Practices
- Discover Before Using - Always use first
tool_search - Be Specific - Narrow queries find better matches
- Check Results - Review tool descriptions before calling
- Enable by Default - is the default
enable: true - Silent Discovery - Don't tell users you're discovering tools
Troubleshooting
| Issue | Solution |
|---|---|
| Tool not found | Try different query terms |
| Too many results | Be more specific in query |
| Tool doesn't work | Check parameters, may need auth |
| Enterprise tool missing | Verify enterprise auth status |
Example Workflows
Finding Incident Tools
javascript
// 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
javascript
// 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
javascript
// 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" })