Skip to content
cccskills
FreePublished on GitHub

mcp-management

Use this skill to discover tools, prompts, and resources exposed by configured Model Context Protocol (MCP) servers, select capabilities for a task, and run tools through a command-line interface or Gemini CLI. It also describes multi-server client patterns and configuration.

OriginalShow the original description

Manage Model Context Protocol (MCP) servers - discover, analyze, and execute tools/prompts/resources from configured MCP servers. Use when working with MCP integrations, need to discover available MCP capabilities, filter MCP tools for specific tasks, execute MCP tools programmatically, access MCP prompts/resources, or implement MCP client functionality. Supports intelligent tool selection, multi-server management, and context-efficient capability discovery.

Run score Not tested

See how to install

Good for

  • Listing capabilities available from configured MCP servers
  • Selecting MCP tools that fit a particular task
  • Calling a specific server tool from the command line
  • Building or troubleshooting an MCP client

Files included (15)

  • SKILL.md6.3 KB
  • assets/tools.json82.5 KB
  • README.md5.8 KB
  • references/configuration.md1.7 KB
  • references/gemini-cli-integration.md4.2 KB
  • references/mcp-protocol.md2.2 KB
  • scripts/.env.example281 B
  • scripts/.gitignore801 B
  • scripts/cli.ts4.2 KB
  • scripts/dist/analyze-tools.js2.5 KB
  • scripts/dist/cli.js4.5 KB
  • scripts/dist/mcp-client.js4.2 KB
  • scripts/mcp-client.ts4.8 KB
  • scripts/package.json539 B
  • scripts/tsconfig.json329 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

MCP Management

Skill for managing and interacting with Model Context Protocol (MCP) servers.

Overview

MCP is an open protocol enabling AI agents to connect to external tools and data sources. This skill provides scripts and utilities to discover, analyze, and execute MCP capabilities from configured servers without polluting the main context window.

Key Benefits:

  • Progressive disclosure of MCP capabilities (load only what's needed)
  • Intelligent tool/prompt/resource selection based on task requirements
  • Multi-server management from single config file
  • Context-efficient: subagents handle MCP discovery and execution
  • Persistent tool catalog: automatically saves discovered tools to JSON for fast reference

When to Use This Skill

Use this skill when:

  1. Discovering MCP Capabilities: Need to list available tools/prompts/resources from configured servers
  2. Task-Based Tool Selection: Analyzing which MCP tools are relevant for a specific task
  3. Executing MCP Tools: Calling MCP tools programmatically with proper parameter handling
  4. MCP Integration: Building or debugging MCP client implementations
  5. Context Management: Avoiding context pollution by delegating MCP operations to subagents

Core Capabilities

1. Configuration Management

MCP servers configured in .claude/.mcp.json.

Gemini CLI Integration (recommended): Create symlink to .gemini/settings.json:

mkdir -p .gemini && ln -sf .claude/.mcp.json .gemini/settings.json

See references/configuration.md and references/gemini-cli-integration.md.

2. Capability Discovery

npx tsx scripts/cli.ts list-tools  # Saves to assets/tools.json
npx tsx scripts/cli.ts list-prompts
npx tsx scripts/cli.ts list-resources

Aggregates capabilities from multiple servers with server identification.

3. Intelligent Tool Analysis

LLM analyzes assets/tools.json directly - better than keyword matching algorithms.

4. Tool Execution

Primary: Gemini CLI (if available)

gemini -y -m gemini-2.5-flash -p "Take a screenshot of https://example.com"

Secondary: Direct Scripts

npx tsx scripts/cli.ts call-tool memory create_entities '{"entities":[...]}'

Fallback: mcp-manager Subagent

See references/gemini-cli-integration.md for complete examples.

Implementation Patterns

Pattern 1: Gemini CLI Auto-Execution (Primary)

Use Gemini CLI for automatic tool discovery and execution. See references/gemini-cli-integration.md for complete guide.

Quick Example:

gemini -y -m gemini-2.5-flash -p "Take a screenshot of https://example.com"

Benefits: Automatic tool discovery, natural language execution, faster than subagent orchestration.

Pattern 2: Subagent-Based Execution (Fallback)

Use mcp-manager agent when Gemini CLI unavailable. Subagent discovers tools, selects relevant ones, executes tasks, reports back.

Benefit: Main context stays clean, only relevant tool definitions loaded when needed.

Pattern 3: LLM-Driven Tool Selection

LLM reads assets/tools.json, intelligently selects relevant tools using context understanding, synonyms, and intent recognition.

Pattern 4: Multi-Server Orchestration

Coordinate tools across multiple servers. Each tool knows its source server for proper routing.

Scripts Reference

scripts/mcp-client.ts

Core MCP client manager class. Handles:

  • Config loading from .claude/.mcp.json
  • Connecting to multiple MCP servers
  • Listing tools/prompts/resources across all servers
  • Executing tools with proper error handling
  • Connection lifecycle management

scripts/cli.ts

Command-line interface for MCP operations. Commands:

  • list-tools - Display all tools and save to assets/tools.json
  • list-prompts - Display all prompts
  • list-resources - Display all resources
  • call-tool <server> <tool> <json> - Execute a tool

Note: list-tools persists complete tool catalog to assets/tools.json with full schemas for fast reference, offline browsing, and version control.

Quick Start

Method 1: Gemini CLI (recommended)

npm install -g gemini-cli
mkdir -p .gemini && ln -sf .claude/.mcp.json .gemini/settings.json
gemini -y -m gemini-2.5-flash -p "Take a screenshot of https://example.com"

Method 2: Scripts

cd .claude/skills/mcp-management/scripts && npm install
npx tsx cli.ts list-tools  # Saves to assets/tools.json
npx tsx cli.ts call-tool memory create_entities '{"entities":[...]}'

Method 3: mcp-manager Subagent

See references/gemini-cli-integration.md for complete guide.

Technical Details

See references/mcp-protocol.md for:

  • JSON-RPC protocol details
  • Message types and formats
  • Error codes and handling
  • Transport mechanisms (stdio, HTTP+SSE)
  • Best practices

Integration Strategy

Execution Priority

  1. Gemini CLI (Primary): Fast, automatic, intelligent tool selection

    • Check: command -v gemini
    • Execute: gemini -y -m gemini-2.5-flash -p "<task>"
    • Best for: All tasks when available
  2. Direct CLI Scripts (Secondary): Manual tool specification

    • Use when: Need specific tool/server control
    • Execute: npx tsx scripts/cli.ts call-tool <server> <tool> <args>
  3. mcp-manager Subagent (Fallback): Context-efficient delegation

    • Use when: Gemini unavailable or failed
    • Keeps main context clean

Integration with Agents

The mcp-manager agent uses this skill to:

  • Check Gemini CLI availability first
  • Execute via gemini command if available
  • Fallback to direct script execution
  • Discover MCP capabilities without loading into main context
  • Report results back to main agent

This keeps main agent context clean and enables efficient MCP integration.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

aesthetic

FreeSummary

Design interfaces by studying reference examples, setting visual rules, and balancing appearance with usability and accessibility. The skill also guides screenshot analysis, iterative design image generation, micro interactions, and documenting design decisions in project guidelines.

  • Analyzing a reference interface
  • Setting a color and typography system
  • Refining a generated design image
mrgoonie/claudekit-skills2.2KUpdated Apr 3, 2026

ai-multimodal

FreeSummary

Use Google Gemini to analyze audio, images, videos, and PDFs, or generate and edit images. Get results such as timestamped transcripts, summaries, extracted tables, answers about media, and images made from prompts.

  • Transcribing audio with timestamps
  • Finding information in images or screenshots
  • Summarizing videos or asking about scenes
mrgoonie/claudekit-skills2.2KUpdated Apr 3, 2026

Use this skill to plan and build backend systems, from API design and authentication to database tuning, security, testing, deployment, and monitoring. It offers technology choices and practical checklists for turning requirements into production-ready services.

  • Choosing a language, framework, database, or API style
  • Designing authentication and authorization
  • Improving database queries and service performance
mrgoonie/claudekit-skills2.2KUpdated Apr 3, 2026

better-auth

FreeSummary

Use this skill to add authentication and authorization to TypeScript applications with Better Auth. It covers email and social sign-in, sessions, database setup, two-factor authentication, passkeys, and access rules, with guidance for several web frameworks.

  • Adding email and password sign-in
  • Setting up Google or GitHub OAuth
  • Adding two-factor authentication or passkeys
mrgoonie/claudekit-skills2.2KUpdated Apr 3, 2026

bunny

FreeSummary

Integrate Bunny.net services through their APIs to configure CDN pull zones, manage stored files and video, edit DNS records, and deploy edge scripts or containers. The skill also covers Shield protection, image optimization, and the credentials each service requires.

  • Setting up a CDN pull zone and purging its cache
  • Uploading or managing files in Edge Storage
  • Creating and uploading Stream videos
mrgoonie/claudekit-skills2.2KUpdated Apr 3, 2026

chrome-devtools

FreeSummary

Use Puppeteer CLI scripts to automate browser tasks and inspect web pages. The skill can navigate, click, fill forms, capture screenshots, collect page data, monitor console and network activity, and measure performance including Core Web Vitals. Results are provided as JSON.

  • Capturing a full page or selected element
  • Automating navigation and form submission
  • Collecting page content for scraping
mrgoonie/claudekit-skills2.2KUpdated Apr 3, 2026

See all skills by mrgoonie

Report a problem with this skill