mcp-orchestration

Routes MCP tools, Claude Skills, and parallel CLI agents to the cheapest capable layer.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/diazMelgarejo/orama-system --skill mcp-orchestration-diazmelgarejo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-orchestration
Source: https://github.com/diazMelgarejo/orama-system/tree/main/bin/orama-system/skills/mcp-orchestration
Command: npx skills add https://github.com/diazMelgarejo/orama-system --skill mcp-orchestration-diazmelgarejo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @modelcontextprotocol/sdk, zod, ai-cli-mcp, gemini-mcp-tool, and includes references (resource) components.

What problem does it solve? Configuring MCP servers across Claude Code, Codex, Gemini, and OpenClaw is error-prone, and teams waste budget by routing every task to expensive models when free or local agents would succeed. ## Core Features & Use Cases - MCP Server Setup & Debugging: Register and verify MCP servers (gemini-mcp-tool, ai-cli-mcp) in Claude Code, Claude Desktop, and OpenClaw with JSON config templates and a verification checklist. - Cost-Aware Model Routing: Route coding tasks to ClinePass, lightweight triage to the OpenRouter free-model fallback chain, local work to ollama, and reserve Gemini strictly for large-context Gemini-Analyzer use-cases. - Parallel Worker Dispatch: Use ai-cli-mcp to run background CLI agents with PID tracking, absolute workFolder paths, and human approval gates before any writes. - Use Case: When an MCP server fails to appear in /mcp or a background agent hangs, follow the troubleshooting table to fix auth, JSON parse errors, or first-run prompt issues. ## Quick Start Ask the agent to set up and verify the ai-cli-mcp and gemini-cli MCP servers in Claude Code and route a coding task to the cheapest capable model.

Frequently Asked Questions about mcp-orchestration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up an MCP server in Claude Code?

Register the server in Claude Code MCP settings with a command like npx and args such as -y ai-cli-mcp@<PINNED_VERSION>, then verify with /mcp or claude mcp list. Always pin package versions instead of using bare @latest.

How do I run parallel AI CLI agents with ai-cli-mcp?

Use ai-cli-mcp's run tool to launch background CLI workers with absolute workFolder paths, then track them with wait, peek, and get_result by PID. Never let workers commit, delete, or deploy without explicit user confirmation.

When should I use Gemini versus OpenRouter free models?

Reserve Gemini for Gemini-Analyzer use-cases: visual diffs, whole-repo architecture mapping, multi-file stale-doc detection, and large-diff reviews. Route all other reading and triage to the OpenRouter free-model fallback chain or local ollama.

Why does my MCP server not appear in /mcp?

The server is usually not registered or the client was not restarted after config changes. Run /mcp and claude mcp list to confirm registration, and check for JSON parse errors caused by debug logs polluting stdout.

Why does claude -p report Not logged in after login?

The OAuth callback server or credential persistence likely failed inside a sandbox. Run claude auth login --claudeai outside the sandbox, then verify with claude auth status and a claude -p probe before dispatching workers.

Can OpenClaw act as both MCP server and client?

Yes. openclaw mcp serve exposes OpenClaw as an MCP server for Claude or Codex, while openclaw mcp set/list/unset manages its outbound registry of MCP servers like ai-cli-mcp and gemini-cli.