Tool Discovery & Search

This skill helps you discover available tools, MCP servers, and plugins. If a tool doesn't exist locally, it automatically searches for solutions.

When This Skill Applies

Activate this skill when:

• User asks about available tools or capabilities
• User wants to know if Claude can do something
• User mentions "MCP", "plugin", "integration", or "tool"
• User seems uncertain about how to accomplish a task
• User asks "is there a way to..." or "can you..."

Current Available Tools

Core Claude Code Tools

Always available without configuration:

• Bash: Execute shell commands, run scripts, system operations
• Read: Read file contents, view code, examine configurations
• Edit: Modify existing files with precise edits
• Write: Create new files, overwrite existing ones
• Glob: Find files by pattern (e.g., **/*.js)
• Grep: Search code for patterns, find text across files
• WebSearch: Search the web for information
• WebFetch: Fetch and read web page content
• LSP: Language server features (go to definition, find references, hover info)
• NotebookEdit: Edit Jupyter notebooks
• Skill: Invoke other skills
• Task: Spawn specialized agents for complex tasks
• TodoWrite: Create and manage task lists
• AskUserQuestion: Ask clarifying questions with options

Connected MCP Servers

Your currently configured MCP servers:

Beeper (messaging & chat)

• Tool: mcp__beeper__search_chats
• Purpose: Search and interact with chat messages across platforms
• Use when: Working with messages, chat history, or messaging platforms

Claude in Chrome (browser automation)

Tools available:

• mcp__claude-in-chrome__javascript_tool: Execute JavaScript in browser
• mcp__claude-in-chrome__read_page: Read page accessibility tree
• mcp__claude-in-chrome__find: Find elements on page
• mcp__claude-in-chrome__form_input: Fill form fields
• mcp__claude-in-chrome__computer: Mouse/keyboard control
• mcp__claude-in-chrome__navigate: Navigate URLs
• mcp__claude-in-chrome__screenshot: Take screenshots
• mcp__claude-in-chrome__gif_creator: Record browser actions as GIF
• mcp__claude-in-chrome__upload_image: Upload images to pages
• mcp__claude-in-chrome__get_page_text: Extract page text
• mcp__claude-in-chrome__tabs_*: Manage browser tabs
• mcp__claude-in-chrome__read_console_messages: Debug JavaScript
• mcp__claude-in-chrome__read_network_requests: Monitor network activity
• mcp__claude-in-chrome__shortcuts_*: Use browser shortcuts/workflows

Use when: Web scraping, browser automation, testing web apps, form filling, web interaction

Episodic Memory (conversation history)

• Tool: mcp__plugin_episodic-memory_episodic-memory__search
• Purpose: Search previous Claude Code conversations
• Use when: Recalling past decisions, finding previous solutions, remembering context

Installed Plugins

Your currently enabled plugins:

• superpowers@superpowers-marketplace: Advanced development workflows
• episodic-memory@superpowers-marketplace: Cross-session memory

Tool Discovery Process

When a user needs a tool that isn't currently available:

Step 1: Understand the Need

Ask clarifying questions:

• What specific task are you trying to accomplish?
• What data/services do you need to interact with?
• What format is the input/output?

Step 2: Search Existing Resources

Check these locations for potential solutions:

1. MCP Registry - Search official MCP servers:

   bash
   1# Search the MCP registry on GitHub
   2gh search repos "mcp server" topic:mcp

2. Claude Plugins Marketplace:

   bash
   1# Check official plugins
   2ls ~/.claude/plugins/marketplaces/claude-plugins-official/plugins/
   3ls ~/.claude/plugins/marketplaces/claude-plugins-official/external_plugins/

3. Awesome MCP Servers: Search https://github.com/punkpeye/awesome-mcp-servers

4. NPM/PyPI for MCP:

   bash
   1# Search npm for MCP servers
   2npm search mcp-server
   3
   4# Search PyPI
   5pip search mcp

Step 3: Present Options

Once you find relevant tools:

1. Describe the tool: What it does and how it helps
2. Installation method: How to install it
3. Configuration needed: What setup is required
4. Example usage: Show how it would solve the user's problem

Step 4: Offer Installation Assistance

Ask the user:

• "I found [tool name] that can [capability]. Would you like me to help install it?"
• Provide installation commands
• Help configure .mcp.json or plugin settings

Common Tool Categories & Solutions

Database Access

• PostgreSQL: @modelcontextprotocol/server-postgres
• SQLite: @modelcontextprotocol/server-sqlite
• MySQL: Search npm for mcp-server-mysql

API Integrations

• GitHub: @modelcontextprotocol/server-github
• GitLab: Available in official plugins
• Slack: Available in official plugins
• Linear: Available in official plugins
• Stripe: Available in official plugins

Development Tools

• Playwright: Browser testing (official plugin)
• Firebase: Firebase integration (official plugin)
• Docker: Search for MCP docker servers
• Kubernetes: Search for MCP k8s servers

Productivity

• Google Drive: Search MCP registry
• Notion: Search MCP registry
• Calendar: Search MCP registry

AI & Data

• Sentry: Error tracking
• Memory/RAG: Episodic memory (already installed!)
• Vector DBs: Search for Pinecone, Weaviate MCP servers

How to Install New MCP Servers

Method 1: NPM-based MCP Server

bash
1# Install globally
2npm install -g @modelcontextprotocol/server-NAME
3
4# Add to ~/.claude.json

Then add configuration to ~/.claude.json:

json
1{
2  "mcpServers": {
3    "server-name": {
4      "command": "npx",
5      "args": ["-y", "@modelcontextprotocol/server-NAME"],
6      "env": {
7        "API_KEY": "your-key-here"
8      }
9    }
10  }
11}

Method 2: Python MCP Server

bash
1# Install with pip
2pip install mcp-server-NAME
3
4# Add to ~/.claude.json

Configuration:

json
1{
2  "mcpServers": {
3    "server-name": {
4      "command": "python",
5      "args": ["-m", "mcp_server_name"],
6      "env": {
7        "API_KEY": "your-key-here"
8      }
9    }
10  }
11}

Method 3: Custom MCP Server

bash
1# Clone repository
2git clone https://github.com/org/mcp-server-name
3cd mcp-server-name
4npm install
5
6# Add to ~/.claude.json with full path

Search Strategy

When searching for a tool:

1. Start broad: "mcp server for [use case]"
2. Check official sources: Anthropic's MCP registry, official plugins
3. Search GitHub: gh search repos "mcp [service name]"
4. Check awesome lists: awesome-mcp-servers, awesome-claude
5. Search package managers: npm, PyPI, crates.io

Example Interactions

User: "Can Claude access my Google Calendar?"

Response pattern:

1. "Let me search for a Google Calendar MCP server..."
2. Use WebSearch or gh search to find options
3. Present findings: "I found [X] MCP server that provides Google Calendar integration"
4. Explain installation and configuration
5. Offer to help set it up

User: "Is there a way to interact with Docker?"

Response pattern:

1. Check if docker MCP exists
2. Search GitHub/npm for docker MCP servers
3. Present options with pros/cons
4. Guide installation if user wants to proceed

User: "What tools do I have?"

Response pattern:

1. List core tools
2. List connected MCP servers with their capabilities
3. List installed plugins
4. Mention discovery capabilities: "I can also search for new tools if you need something specific"

Proactive Discovery

When you notice the user struggling with a task:

• Suggest: "This task might be easier with [tool]. Would you like me to search for an MCP server that can help?"
• Offer: "I can search the MCP registry for solutions if you'd like"

Important Notes

• Always verify tool compatibility before suggesting installation
• Check if tools require API keys or authentication
• Warn about security implications of tools that access sensitive data
• Prioritize official Anthropic MCP servers when available
• Test that installed tools work before declaring success

Quick Reference Commands

bash
1# Search MCP registry
2gh search repos topic:mcp "keyword"
3
4# List installed MCP servers
5cat ~/.claude.json | grep -A 5 mcpServers
6
7# List available plugins
8ls ~/.claude/plugins/marketplaces/
9
10# Check skill availability
11ls ~/.claude/skills/
12
13# Search npm for MCP
14npm search mcp-server

When to Use This Skill

✅ User asks "what can Claude do?" ✅ User wants to know available integrations ✅ User needs a capability that might require a new tool ✅ User mentions a service/API by name ✅ User seems uncertain about how to proceed

❌ User has a clear plan and knows what tools to use ❌ Task is straightforward with existing tools ❌ User is already using a specific tool successfully