mcp-cli-tools

MCP server that gives AI coding agents (Claude Code, Cursor, Cline, etc.) safe access to multiple AI models through Antigravity CLI and OpenAI Codex CLI.

Think of it as a local Fugu-style orchestrator: your AI agent can consult Gemini, GPT, and other models mid-conversation, compare answers, ask for adversarial review, and run scoped code reviews without leaving the editor.

What it does

Tool	Backend	Capability
fugu_orchestrate	Antigravity CLI (agy)	Fugu-style single entry point: fast routing or ultra workflow with subtasks, model_id, access_list, shared memory, and synthesis
consult_model	Antigravity CLI (agy)	Ask one external model for a second opinion
compare_models	Antigravity CLI (agy)	Ask 2-4 models in parallel and synthesize agreement/disagreement
adversarial_check	Antigravity CLI (agy)	Ask a model to attack a proposal, plan, or implementation idea
review_workspace	OpenAI Codex CLI	Run scoped code review on uncommitted changes, a base branch, or a commit
security_audit	OpenAI Codex CLI	Run a security-focused Codex review prompt
run_antigravity	Antigravity CLI (agy)	Compatibility wrapper with safe subcommands only
run_codex	OpenAI Codex CLI	Compatibility wrapper for codex review only

Your AI agent gains the ability to:

• Get a second opinion from a different model family
• Use a single Fugu-style tool that hides routing, decomposition, worker calls, and final synthesis
• Compare multiple external answers in one tool call
• Run code reviews via Codex without leaving the conversation
• Do adversarial verification (one model checks another's work)
• Route by expertise — Gemini for analysis, GPT for code review
• Receive structured metadata for each call: command, cwd, exit code, timeout, duration, stdout, stderr

Prerequisites

• Antigravity CLI installed as agy
• OpenAI Codex CLI installed as codex
• Node.js 18+

Install

git clone https://github.com/Marcelo-Henry/mcp-cli-tools.git
cd mcp-cli-tools
npm install
npm run build

Configure in Claude Code

Add to ~/.claude/settings.json under mcpServers:

{
  "mcpServers": {
    "cli-tools": {
      "command": "node",
      "args": ["/path/to/mcp-cli-tools/dist/index.js"]
    }
  }
}

Usage

fugu_orchestrate

Use this as the main entry point when you want behavior closest to Fugu/Fugu-Ultra.

Fast mode selects one worker for lower latency:

fugu_orchestrate(
  task: "Explain this TypeScript error and suggest the smallest fix",
  mode: "fast",
  effort: "standard",
  cwd: "/path/to/repo"
)

Ultra mode builds and executes a workflow with model_id, subtasks, access_list, critique, and synthesis:

fugu_orchestrate(
  task: "Create a local task dashboard from scratch with persistence, tests, and a polished UI",
  mode: "ultra",
  effort: "max",
  sharedMemoryKey: "taskpulse",
  cwd: "/path/to/repo"
)

Restrict the worker pool when privacy, cost, or compliance matters:

fugu_orchestrate(
  task: "Analyze this architecture",
  mode: "ultra",
  excludeModels: ["gpt-oss-120b"]
)

fugu_orchestrate is a local deterministic orchestration layer inspired by the public Fugu/Fugu-Ultra workflow shape. It is not Sakana's learned orchestrator model.

consult_model

Ask one external model:

consult_model(prompt: "Analyze this architecture", model: "gemini-3.1-pro", cwd: "/path/to/repo")

compare_models

Ask multiple models in parallel:

compare_models(
  prompt: "Which migration strategy is safest for this repo?",
  models: ["gemini-3.5-flash", "gemini-3.1-pro"]
)

adversarial_check

Ask an external model to find flaws in a proposal:

adversarial_check(
  proposal: "Move all orchestration policy into CLAUDE.md",
  context: "MCP server for Claude Code + GPT/Gemini collaboration"
)

review_workspace

Review uncommitted changes:

review_workspace(scope: "uncommitted", cwd: "/path/to/repo")

Review against a branch:

review_workspace(scope: "base", base: "main", cwd: "/path/to/repo")

Review a commit:

review_workspace(scope: "commit", commit: "abc123", cwd: "/path/to/repo")

security_audit

Run a security-focused review:

security_audit(instructions: "Focus on command execution and path traversal", cwd: "/path/to/repo")

Compatibility tools

run_antigravity and run_codex remain available for existing Claude rules, but they are intentionally narrower now.

run_antigravity

Query any model available in Antigravity CLI:

run_antigravity(promptContext: "Analyze this architecture", model: "gemini-3.1-pro")

List available models:

run_antigravity(subcommand: "models")

Run safe subcommands:

run_antigravity(subcommand: "help")
run_antigravity(subcommand: "changelog")

Allowed subcommands are models, help, and changelog. Plugin/install/update operations are blocked by design.

run_codex

Review uncommitted changes:

run_codex(action: "review", flags: ["--uncommitted"], cwd: "/path/to/repo")

Review with a specific prompt:

run_codex(action: "review", prompt: "Focus on security vulnerabilities")

Review against a branch:

run_codex(action: "review", flags: ["--base", "main"], cwd: "/path/to/repo")

Use a specific model:

run_codex(action: "review", prompt: "Audit this code", model: "gpt-5", cwd: "/path/to/repo")

Notes:

• prompt e flags são mutuamente exclusivos e agora são validados pelo MCP.
• Use cwd quando o comando depender do contexto de um repositório específico.
• action agora aceita apenas review.
• flags aceita apenas --uncommitted, --base, --commit, --title e --strict-config.

Error handling

Os tools retornam:

• comando executado
• cwd usado
• exit_code
• duration_ms
• stdout e stderr
• structuredContent com metadata da chamada

Se o processo sair com código diferente de zero, receber sinal ou estourar timeout, o resultado é marcado como erro no protocolo MCP.

Available Models

Via Antigravity

Model	Best for
gemini-3.5-flash	Fast exploration, brainstorming (default)
gemini-3.1-pro	Deep analysis, architecture, large context
gpt-oss-120b	Independent perspective, diverse opinion

Via Codex

Codex models depend on your local Codex CLI configuration. Pass the model explicitly when needed:

review_workspace(scope: "uncommitted", model: "gpt-5", cwd: "/path/to/repo")
security_audit(model: "gpt-5", cwd: "/path/to/repo")

Making your AI agent orchestrate automatically

Add orchestration rules to your global ~/.claude/CLAUDE.md to make Claude Code call these tools proactively. See ORCHESTRATION.md for a full guide with triggers and patterns.

License

MIT