Analyze MCP Server Structure
This skill analyzes an MCP server configuration and generates a comprehensive wrapping strategy.
When This Skill Activates
Use this skill when:
- •User asks about analyzing an MCP server
- •User wants to understand MCP server capabilities
- •User needs a wrapping strategy for an MCP server
- •User requests tool inventory for an MCP
- •Preparing to create a CLI wrapper
What This Skill Does
- •Reads MCP server configuration from Claude Code
- •Introspects available tools and their signatures
- •Groups tools into logical namespaces
- •Designs 4-level progressive disclosure help structure
- •Recommends detail level enums for optimization
- •Estimates token savings potential
- •Generates implementation roadmap
Usage
code
User: "Analyze the GitHub MCP server" User: "What tools does the firecrawl MCP provide?" User: "Create a wrapping strategy for the ref MCP"
Output
Generates a comprehensive analysis report with:
- •Tool inventory grouped by namespace
- •Progressive disclosure structure (4 levels)
- •Detail level recommendations
- •Token efficiency estimates
- •Implementation roadmap
Example Output
markdown
# MCP Server Analysis: github ## Server Overview - Name: github - Transport: stdio - Tools Count: 15 - Configuration: ~/.config/claude/mcp.json ## Tool Inventory ### Namespace: repository - **repository.get**: Get repository information - **repository.list**: List user repositories - **repository.create**: Create new repository ### Namespace: issue - **issue.list**: List repository issues - **issue.create**: Create new issue - **issue.update**: Update issue ## Progressive Disclosure Structure [4-level help outline] ## Token Efficiency Estimate - Traditional approach: ~80,000 tokens per complex workflow - Code API approach: ~5,000 tokens (93.8% savings) ## Implementation Roadmap [Step-by-step plan]
Agent Context
This skill runs in a forked context using the mcp-analyzer agent, which has specialized knowledge of:
- •MCP protocol introspection
- •Tool categorization patterns
- •Progressive disclosure design
- •Token efficiency optimization
- •CLI wrapper patterns from ~/cli-wrappers/