Decision guides

CLI vs MCP for AI Agents

Choose between command-line tools, MCP integrations, and APIs based on the work rather than a universal winner.

Compare where execution happens, whose identity is used, what output is returned, and how writes are approved.

Recommended starting points

Start with a common decision or workflow, then narrow the commands and permissions for your environment.

Interface decisionsRead only
Choose CLI for shell-native local and CI work; choose MCP when typed discovery and mediated remote permissions matter more.

Select the smallest interface that completes the task with understandable identity, output, and approval boundaries.

1 tools3 approval points
Interface decisionsRead only
Use gh when local Git and shell context are central; use GitHub MCP when the agent needs a mediated catalog of GitHub operations.

Choose a GitHub interface that matches repository context, credential ownership, and permitted write actions.

1 tools3 approval points
Tool choicesRead only
Choose curl for portability and precise scripting; choose HTTPie for readable interactive requests and convenient sessions.

Select an HTTP client whose command and failure behavior remain clear to both the agent and reviewer.

2 tools3 approval points

CLI vs MCP for AI agents and tool decisions

Each destination is a complete, source-backed page with a clear outcome and operating boundary.

Interface decisions

Interface decisionsRead only
Choose CLI for shell-native local and CI work; choose MCP when typed discovery and mediated remote permissions matter more.

Select the smallest interface that completes the task with understandable identity, output, and approval boundaries.

1 tools3 approval points
Interface decisionsRead only
Use gh when local Git and shell context are central; use GitHub MCP when the agent needs a mediated catalog of GitHub operations.

Choose a GitHub interface that matches repository context, credential ownership, and permitted write actions.

1 tools3 approval points
Interface decisionsRead only
Use kubectl for explicit shell-native cluster inspection; use a Kubernetes MCP integration when a constrained tool catalog improves governance.

Choose cluster access that makes context, identity, namespace, and mutation boundaries obvious.

1 tools3 approval points
Interface decisionsRead only
Use a CLI and test code for repeatable browser checks; use MCP for supervised exploration when tool-mediated observation matters.

Choose a browser interface that matches whether the task is exploration, a durable test, or an authenticated user action.

1 tools3 approval points

Tool choices

Tool choicesRead only
Choose curl for portability and precise scripting; choose HTTPie for readable interactive requests and convenient sessions.

Select an HTTP client whose command and failure behavior remain clear to both the agent and reviewer.

2 tools3 approval points
Tool choicesRead only
Choose against the project’s existing state, provider support, governance, and licensing requirements; do not switch engines casually.

Select an infrastructure CLI without risking state divergence or an unreviewed migration.

2 tools3 approval points
Tool choicesRead only
Use jq for JSON-first work and yq for YAML or mixed configuration formats; preview either transformation before replacing files.

Choose the data CLI that natively matches the input format and keeps transformations deterministic.

2 tools3 approval points
Tool choicesRead only
Choose ripgrep for new agent workflows and modern repository search; keep ag where an existing environment or script depends on it.

Select a predictable code-search command whose ignored files, binary handling, regex, and output are understood.

1 tools3 approval points
Tool choicesRead only
Use Firecrawl for extraction-first content workflows and Playwright for browser behavior, screenshots, tests, and necessary interaction.

Choose the least complex web interface that returns the required evidence without unnecessary browsing or crawling.

2 tools3 approval points

Agent choices

Agent choicesRead only
Both can use the same external CLI stack; choose based on the execution controls, project workflow, and product surface available to your team.

Separate the choice of coding agent from the independent choice of safe, parseable command-line tools.

3 tools3 approval points

How to choose the right guide

Compare one task

Evaluate both choices against the same input, identity, output, and success condition.

Locate execution

Decide whether work belongs in a local shell, CI runner, managed integration, or service.

Inspect the permission surface

Compare available commands or tools, credential scope, parameter validation, and write controls.

Choose a fallback

Keep a second interface or recovery route when the preferred option cannot complete the task safely.

What every guide gives you

Conditional recommendation

See which option fits each environment instead of a universal winner.

Shared decision criteria

Compare identity, output, failure behavior, governance, and operational risk.

Approval boundaries

Identify credentials, mutations, and scope changes that require a person.

Hybrid option

Combine CLI, MCP, and APIs when their responsibilities remain explicit.

Continue through the registry

Check the CLI side against documented commands and evidence.

See the decision applied to a bounded workflow.

Match the chosen interface to an agent sandbox and approval policy.