| name | MCP Catalog Explorer |
| description | List, check health, and call tools from the PMOVES-BoTZ MCP server catalog. Use when user mentions "list mcp servers", "check mcp health", "call mcp tool", "mcp catalog", or "show mcp servers". |
MCP Catalog Explorer Skill
Discover and interact with MCP servers registered in the PMOVES-BoTZ catalog.
Overview
This skill provides tools to:
- List MCP Servers: View all registered MCP servers from the catalog
- Health Check: Verify if an MCP server is running and responsive
- Call Tool: Execute a tool on a specific MCP server
Skill Structure
.claude/skills/mcp-catalog/
├── SKILL.md # This file
├── tools/
│ ├── list_servers.py # Parse and list catalog entries
│ ├── health_check.py # Check server health status
│ └── call_tool.py # Route tool calls to servers
└── cookbook/
└── discovery.md # Usage examples and workflows
Trigger Phrases
| Phrase | Action |
|---|
| "list mcp servers" | Run tools/list_servers.py |
| "show mcp catalog" | Run tools/list_servers.py |
| "check mcp health" | Run tools/health_check.py --server <name> |
| "is [server] running" | Run tools/health_check.py --server <name> |
| "call mcp tool" | Run tools/call_tool.py --server <name> --tool <tool> |
| "execute [tool] on [server]" | Run tools/call_tool.py --server <name> --tool <tool> |
Tools
list_servers.py
Lists all MCP servers from the BoTZ catalog.
Usage:
python tools/list_servers.py
python tools/list_servers.py --format json
python tools/list_servers.py --filter sse
python tools/list_servers.py --filter stdio
Output:
MCP Server Catalog (7 servers)
================================================================================
docling
Transport: sse
URL: http://localhost:3020/sse
Description: Document processing and conversion
cipher-memory
Transport: stdio
Command: docker exec -i pmz-cipher python3 memory_shim/app_cipher_memory.py
Description: Persistent memory and reasoning
...
health_check.py
Checks the health status of an MCP server.
Usage:
python tools/health_check.py --server docling
python tools/health_check.py --server cipher-memory
python tools/health_check.py --all
Output:
Health Check: docling
================================================================================
Status: HEALTHY
Transport: SSE
URL: http://localhost:3020/sse
Response Time: 45ms
call_tool.py
Calls a tool on a specific MCP server.
Usage:
python tools/call_tool.py --server docling --tool convert --args '{"file": "doc.pdf"}'
python tools/call_tool.py --server cipher-memory --tool store_memory --args '{"key": "test", "content": "value"}'
Output:
Tool Call: docling.convert
================================================================================
Status: SUCCESS
Result: {"output": "doc.md", "pages": 5}
Cookbook
For detailed examples and workflows, see cookbook/discovery.md.
Quick Examples
List all servers:
cd .claude/skills/mcp-catalog
python tools/list_servers.py
Check if Docling is healthy:
python tools/health_check.py --server docling
Check all servers at once:
python tools/health_check.py --all
Catalog Location
The skill reads the MCP catalog from:
external/PMOVES-BoTZ/core/mcp/catalog.yml
This YAML file defines all registered MCP servers with their:
- Name and description
- Transport type (SSE or stdio)
- URL (for SSE) or command (for stdio)
- Required environment variables
Server Types
SSE Servers
HTTP-based servers using Server-Sent Events:
- docling: Document processing (Port 3020)
- e2b: Code execution sandbox (Port 7071)
- vl-sentinel: Vision-language processing (Port 7072)
Health check: HTTP GET to /health endpoint
stdio Servers
Docker-based servers using standard I/O:
- cipher-memory: Persistent memory system
- postman: API testing
- n8n-agent: Workflow automation
- hostinger: VPS/DNS management
Health check: Verify container is running via docker ps
Quick Reference
Related Files
