ck-use-mcp

name	ck:use-mcp
description	Utilize MCP server tools with intelligent discovery and execution.
argument-hint	[task]
metadata	{"author":"claudekit","version":"1.0.0"}

MCP Tool Execution

Execute MCP operations via Gemini CLI to preserve context budget.

Execution Steps

1. Execute task via Gemini CLI (using stdin pipe for MCP support):

   # IMPORTANT: Use stdin piping, NOT -p flag (deprecated, skips MCP init)
   # Read model from .opencode/.ck.json: gemini.model (default: gemini-3-flash-preview)
   echo "$ARGUMENTS. Return JSON only per GEMINI.md instructions." | gemini -y -m <gemini.model>
   

2. Fallback to mcp-manager subagent (if Gemini CLI unavailable):

   • Use mcp-manager subagent to discover and execute tools
   • If the subagent got issues with the scripts of ck:mcp-management skill, use ck:mcp-builder skill to fix them
   • DO NOT create ANY new scripts
   • The subagent can only use MCP tools if any to achieve this task
   • If the subagent can't find any suitable tools, just report it back to the main agent to move on to the next step

Important Notes

• MUST use stdin piping - the deprecated -p flag skips MCP initialization
• Use -y flag to auto-approve tool execution
• GEMINI.md auto-loaded: Gemini CLI automatically loads GEMINI.md from project root, enforcing JSON-only response format
• Parseable output: Responses are structured JSON: {"server":"name","tool":"name","success":true,"result":<data>,"error":null}

Anti-Pattern (DO NOT USE)

# BROKEN - deprecated -p flag skips MCP server connections!
gemini -y -m <gemini.model> -p "..."

# ALSO BROKEN - --model flag with -p
gemini -y -p "..." --model gemini-3-flash-preview