MCP vs CLI: Choosing the Right Developer Tool
CLI offers direct human control and automation, while MCP provides AI agents structured context for intelligent API interaction. Understand their roles to choose wisely for future-proof development.
TL;DR
1. CLI offers direct, powerful control and automation for repetitive tasks and system interactions.
2. MCP provides structured, machine-readable API context, essential for intelligent AI agents and autonomous workflows.
3. Choosing between them depends on the task: CLI for human-driven precision, MCP for AI-driven orchestration.
4. The future likely involves a synergy where CLIs help build and manage MCP-ready APIs, and MCP empowers AI agents.
5. Prioritizing both direct developer control and AI-agent compatibility ensures future-proof API strategies and improved developer experience.
Get started with DigitalAPI today. Book a Demo!
The rhythm of modern software development beats to the tune of efficiency and control. For decades, the command line interface (CLI) has been the developer's trusted companion, offering unparalleled precision, automation capabilities, and a direct conduit to system resources. It’s the language of power users, a bedrock of repeatable workflows. Yet, a new force is quietly reshaping this landscape: the Model Context Protocol (MCP).
Born from the imperative to enable intelligent AI agents, MCP proposes a new way for software to communicate, moving beyond human-centric documentation to structured, machine-readable context. As AI integration becomes ubiquitous, developers now find themselves at a crucial crossroads: continue with the familiar, embrace the new, or discover a path where both tools empower the next generation of innovation.
Understanding the Landscape: CLI's Enduring Reign
For a significant period, the Command Line Interface (CLI) has stood as a testament to developers' need for speed, control, and efficiency. It’s a text-based interface used to operate software and operating systems, allowing users to issue commands as lines of text. Far from being a relic of the past, the CLI remains an indispensable tool in virtually every developer's toolkit, from scripting automation to managing cloud infrastructure.
What Exactly is a CLI?
A Command Line Interface (CLI) is a program that accepts text as input to execute operating system functions. Unlike graphical user interfaces (GUIs) that rely on visual interactions (mouse clicks, drag-and-drop), CLIs demand precision through typed commands. This direct interaction with the system's core capabilities grants developers immense power, allowing for highly specific and repeatable actions.
Popular examples include:
- Git CLI: Managing version control, commits, branches, and merges.
- AWS CLI, Azure CLI, gcloud CLI: Interacting with cloud services for provisioning, managing resources, and deploying applications.
- Docker CLI: Building, running, and managing containers.
- kubectl: Controlling Kubernetes clusters.
- npm/yarn: Managing JavaScript packages.
These tools exemplify the CLI's utility in modern development workflows, enabling tasks that range from trivial file operations to complex multi-service deployments.
Key Advantages of CLI for Developers
The continued dominance of CLIs isn't accidental; it's rooted in a set of powerful advantages that resonate deeply with developer needs:
- Speed and Efficiency: For experienced users, typing commands can be significantly faster than navigating menus and clicking buttons in a GUI. Repetitive tasks are executed with minimal keystrokes.
- Automation and Scripting: CLIs are inherently scriptable. Developers can string together multiple commands into shell scripts (Bash, Python, PowerShell) to automate complex workflows, build CI/CD pipelines, and perform batch operations. This capability is fundamental to modern DevOps practices and API orchestration.
- Precision and Control: CLIs offer granular control over system resources and application behavior. Developers can specify exact parameters and arguments, leading to precise and predictable outcomes.
- Resource Friendliness: CLIs often consume fewer system resources (CPU, RAM) compared to heavy GUIs, making them ideal for remote servers, embedded systems, or environments where resources are constrained.
- Integration and Composability: CLI tools are designed to be composable. Their output can often be piped as input to other tools, enabling sophisticated data processing and workflow chaining. This makes them excellent components within a larger API management ecosystem.
Common Use Cases for CLI in Development
Developers leverage CLIs across almost every facet of the software development lifecycle:
- Local Development: Running build commands, testing suites, managing dependencies, starting development servers.
- Version Control: Interacting with Git repositories for committing, branching, merging, and pushing code.
- Cloud Resource Management: Provisioning virtual machines, configuring networks, managing storage, deploying serverless functions, and interacting with API gateways.
- Containerization and Orchestration: Building Docker images, running containers, and deploying applications to Kubernetes clusters.
- CI/CD Pipelines: Scripting automated tests, deployments, and infrastructure as code (IaC) operations.
- System Administration: Monitoring system performance, managing users and permissions, troubleshooting network issues.
The CLI's versatility makes it an enduring cornerstone of efficient and productive development, allowing developers to maintain direct, granular control over their environments and projects.
The Rise of MCP: A Paradigm Shift for AI-Driven Development
While CLIs serve as a powerful interface for human developers, the burgeoning world of Artificial Intelligence introduces new demands, particularly for autonomous agents interacting with complex software ecosystems. This is where the Model Context Protocol (MCP) emerges as a transformative concept, aiming to bridge the gap between human-readable API documentation and machine-understandable instructions for AI.
What is MCP? The Foundation for Intelligent API Consumption
The Model Context Protocol (MCP) is a standardized approach to providing rich, structured, machine-readable context around APIs, specifically designed to enable intelligent AI agents (like Large Language Models or autonomous software agents) to understand, discover, and interact with services more effectively. Unlike traditional API documentation, which is primarily for human consumption, MCP focuses on providing semantic meaning and operational guidelines that AI can parse and act upon without extensive human intervention. As detailed in our blog, What is Model Context Protocol, it's about making APIs truly AI-native.
Key components of MCP typically include:
- Structured Metadata: Beyond basic OpenAPI specifications, MCP incorporates rich metadata about an API's purpose, capabilities, dependencies, side effects, and constraints.
- Semantic Definitions: Using ontologies or shared vocabularies to define the meaning of data inputs and outputs, allowing AI agents to reason about the data.
- Contextual Guidelines: Providing instructions on how an API should be used in specific scenarios, including authentication flows, error handling, and sequences of operations.
- Self-Descriptive Capabilities: Enabling APIs to communicate their own functionality and context in a way that AI can interpret dynamically.
The goal is to move beyond simple function calls to truly intelligent API consumption, where an AI agent can understand the intent behind an API, much like a human developer would after reading extensive documentation.
Why MCP is Emerging: Addressing the Limitations of Traditional APIs for AI
The need for MCP arises from fundamental limitations when integrating AI agents with existing APIs:
- Ambiguity in Natural Language Documentation: AI models struggle to consistently and reliably interpret human-written API documentation, leading to errors, security risks, and unpredictable behavior.
- Lack of Semantic Understanding: Traditional API specs (like OpenAPI) define syntax but not the deeper semantic meaning or business context. An AI might know how to call an endpoint, but not why or when it's appropriate.
- Manual Integration Overhead: Integrating AI with APIs currently requires significant human effort to prompt engineering, fine-tune models, or write glue code to guide the AI. This is not scalable for autonomous systems.
- Dynamic API Discovery: AI agents need to dynamically discover and adapt to new APIs or changes in existing ones without being hardcoded. MCP facilitates this by making APIs truly self-descriptive for machines.
- Governance and Control for Agents: As AI agents become autonomous, controlling their API interactions for security and compliance becomes paramount. MCP can embed API governance rules and guardrails directly into the machine-readable context.
Key Advantages of MCP for AI-Driven Workflows
Adopting MCP principles offers substantial benefits for organizations embracing AI:
- AI-Ready APIs: Transforms existing APIs into assets that AI agents can consume reliably and intelligently, accelerating AI API management.
- Enhanced Discoverability for Agents: Allows AI systems to autonomously explore and identify relevant APIs based on their capabilities and context, much like a developer uses an API developer portal.
- Reduced Integration Friction: Minimizes the need for human intervention in API integration for AI, enabling more autonomous workflows and reducing development cycles.
- Improved Reliability and Security: By providing explicit constraints and guidelines, MCP helps prevent AI agents from misusing APIs or generating unexpected side effects, enhancing API security.
- Scalable AI Orchestration: Facilitates the creation of complex AI agent workflows that can dynamically interact with a multitude of services. This is crucial for the future of agentic AI.
Specific Use Cases for MCP
MCP is poised to revolutionize several areas:
- Autonomous Software Agents: Enabling AI agents to perform complex, multi-step tasks by interacting with various APIs without human oversight (e.g., booking a trip, managing financial accounts).
- Dynamic API Integration: AI systems automatically integrating with new APIs or adapting to API changes on the fly.
- Enterprise Automation: Automating business processes by allowing AI to interface with internal enterprise systems via their APIs.
- Enhanced Chatbots and Virtual Assistants: Powering conversational AI that can perform real actions by understanding user intent and mapping it to API calls.
In essence, MCP aims to create a world where APIs are not just data pipes but intelligent interfaces that can be understood and leveraged by autonomous systems, paving the way for truly self-aware software ecosystems.
CLI vs API vs MCP: The three-way comparison
Most teams arrive at this question already comparing two interfaces, but in practice there are three ways an AI agent can take action against an external system. They overlap, but they solve different problems.
The simple way to read this:
- Use CLI when you're automating your own workflow and a polished CLI already exists (git, gh, kubectl, docker, aws, psql, terraform).
- Use API when one service needs to call another service in a fixed integration.
- Use MCP when your agent needs to act on behalf of other people's users, across multiple SaaS systems, with audit trails and per-user scopes.
The same agent can use all three, and in production it usually will.
Head-to-Head Comparison: MCP vs. CLI
Before the qualitative breakdown, here are the numbers that drive the 2026 conversation. The benchmarks below come from public agent evaluations comparing CLI-driven and MCP-driven workflows on equivalent tasks.
The headline: CLI is dramatically cheaper, faster, and (today) more reliable. MCP is structurally safer for multi-user scenarios and provides the audit posture enterprises need. Neither is "better." The right call depends on what the agent is doing and for whom.
The MCP Tax: why context window cost matters
The cost difference between CLI and MCP isn't about throughput or compute. It's about what the LLM has to read before it can do any work.
When an agent connects to an MCP server, the server's tool definitions (every tool, its description, its JSON Schema, all parameters) are loaded into the model's context window. A single GitHub-style MCP server can inject 30,000 to 80,000 tokens of schema into the conversation before the agent has even decided what to do. Connect three servers and you can spend more than 100,000 tokens just on definitions.
This is the MCP Tax: schema overhead the model pays on every interaction.
CLI commands carry essentially zero schema overhead. The LLM has already seen git commit, kubectl get pods, and aws s3 ls thousands of times during training. The model doesn't need a schema to know how gh issue create --title "..." works.
What the MCP Tax means in practice
- Cost: at 10,000 operations per month, the schema overhead alone can push MCP usage 10x to 30x more expensive than equivalent CLI calls.
- Context budget: every token spent on tool definitions is a token the model can't spend on reasoning about the actual task. On long-running agentic workflows this compounds quickly.
- Reliability: more schema in context generally correlates with degraded recall and worse tool selection. Several 2026 benchmarks show CLI agents completing tasks at near 100% reliability while equivalent MCP agents fall to ~72% on identical workloads.
How to reduce the MCP Tax when MCP is the right choice
- Lazy-load tool definitions via gateways that filter the tool catalog per agent or per task.
- Use minimal schemas with short descriptions optimized for model comprehension, not human documentation.
- Pool servers behind a single gateway so the agent connects once instead of 5-10 times.
- Cache tool listings at the host level instead of re-fetching every turn.
This is one of the things a managed MCP gateway like DigitalAPI handles natively: agents see only the tools they're scoped to, schemas are normalized for token efficiency, and the gateway absorbs the discovery cost so the agent doesn't pay it on every interaction.
Why LLMs are naturally better at CLI
The cost difference is only half of the CLI advantage. The other half is that frontier LLMs were trained on a Web full of CLI usage.
Stack Overflow answers are dense with shell commands. GitHub READMEs ship with npm install, cargo run, docker compose up. Tutorials use git rebase -i, aws configure, kubectl apply -f. Blog posts chain shell operations together with pipes. By the time a model is deployed, it has seen millions of examples of how popular CLIs are used, including edge cases, common errors, and idiomatic flag combinations.
This produces a compounding advantage:
- The model already knows the tools exist. No schema discovery needed.
- The model already knows the syntax. Flag combinations, subcommands, and argument ordering are familiar.
- The model can improvise. Because it has seen thousands of piped command chains, it can compose novel combinations confidently (
gh pr list | head -5 | xargs ...). - Error recovery is well-trodden. Models have seen what CLI error messages look like and how to recover from them.
MCP doesn't have this advantage yet. The protocol is barely 18 months old. A model encountering a freshly-published MCP server has to read the schema, infer the semantics, and reason about which tool to call, all from definitions it hasn't seen at training time.
Where the training-data advantage breaks down:
- SaaS without CLIs. No model has trained on
salesforce-cli update-contact-on-customer-record, because that CLI doesn't exist. - Internal services. Your company's bespoke billing service has never appeared in training data, so the model has no prior to draw on.
- Authentication-heavy multi-tenant flows. Even where a CLI exists, training data doesn't help if the model has to navigate per-user OAuth across tenants.
This is exactly the territory where MCP earns its place. The protocol gives the model a structured, discoverable interface to systems the training data never covered.
When to Choose CLI: scenarios where direct control wins
CLI is the right call whenever the agent is acting as you, on systems where a mature CLI already exists, in your inner developer loop. Concretely:
- Git workflows:
git,ghfor issues and PRs, branch operations, history inspection. - Container and orchestration:
docker,docker compose,kubectl,helm. - Cloud infrastructure:
aws,gcloud,az,terraform,pulumi. - Local databases:
psql,mongosh,redis-cli,sqlite3. - Build, test, lint:
npm,pnpm,cargo,go,pytest,eslint,ruff. - CI/CD orchestration:
circleci,gh actions run,argo. - System administration:
systemctl,journalctl,ssh,rsync. - One-shot data manipulation:
jq,awk,sed,csvkit. - Security and audit work:
nmap,trivy,semgrep,gitleaks.
If a polished CLI exists for the tool, the LLM already knows how to use it, and you're the only user, default to CLI. You'll pay 10-30x less in tokens, hit higher task completion rates, and have a simpler debugging path.
When to Embrace MCP: scenarios where the protocol wins
MCP is the right call whenever the agent has to act on behalf of someone else, across systems that don't have CLIs, with scoped per-user authentication. Concretely:
- SaaS without first-class CLIs: Slack channels, Notion pages, Stripe customers, Linear tickets, Salesforce records, HubSpot deals.
- Multi-tenant customer-facing agents: support assistants reading a customer's Zendesk, finance assistants pulling a tenant's Stripe data, sales assistants writing to a rep's HubSpot.
- Background and cron agents: any agent that runs unattended needs structured auth and audit, not shell history.
- Cross-system orchestration with consent gates: "create a Linear ticket from this Zendesk message and post a summary to Slack" with explicit approval on the write actions.
- Compliance-sensitive workflows: healthcare, finance, public sector. The structured audit trail is the compliance posture.
- Internal services without CLIs: company billing, customer success platforms, custom microservices the model has never seen at training time.
- Real-time, capability-aware integrations: servers that update their tool list mid-session (new entitlements, dynamic permissions) so the agent sees only what it's currently allowed to use.
- Multi-agent platforms: when one team of agents needs to use the same tool fleet with different scopes per agent.
In short: if the agent stops being you and starts representing someone else, switch to MCP.
How Modern AI Coding Agents Use CLI and MCP
In practice, most agent systems use both interfaces together.
- Claude Code relies heavily on CLI access because models are exceptionally good at understanding terminal commands, file systems, Git workflows, and developer tooling. MCP is typically used when Claude needs access to external systems such as databases, SaaS applications, ticketing platforms, or enterprise APIs.
- Cursor combines native IDE operations, terminal access, and MCP tools in the same session. A coding task may start with CLI commands, switch to file edits, and then invoke MCP tools to retrieve information from external services.
- Gemini CLI similarly demonstrates how agent workflows often begin in the terminal while selectively using structured tools when external integrations are required.
The Inflection Point: when your agent acts for someone else
There's one question that resolves most CLI vs MCP debates cleanly. It's not about cost, performance, or features. It's about who the agent is acting for.
Acting as you
- The agent runs on your machine, with your credentials, executing your workflow.
- Mistakes affect you and only you.
- Audit trail = shell history is fine, because you are both the user and the reviewer.
- CLI is the right default.
Acting for someone else
- The agent runs on shared infrastructure, with per-user scoped credentials, executing workflows on behalf of customers, teammates, or tenants.
- Mistakes affect other people, sometimes irreversibly.
- Audit trail must be structured, attributable, and queryable, because the next person reading it is a security reviewer or auditor, not you.
- MCP is the right default.
Why this matters: the architectural requirements flip the moment you cross this line. Per-user auth that was a nice-to-have becomes mandatory. Token scoping that was optional becomes contractual. Audit logging that was nice for debugging becomes evidence in a compliance review. CLI sessions cannot meet these requirements at the protocol level. MCP can, by design.
A few patterns to recognize
- Cron and scheduled agents are almost always acting for someone else, even when they were originally configured by you. Treat them as MCP candidates.
- Customer-facing chat surfaces are always acting for the end user. Treat them as MCP.
- CI/CD bots sit in a gray area: they act for the team, not the individual. MCP is usually the right call for write paths; CLI is fine for read paths.
- Local dev assistants are almost always acting as you. CLI is the right default.
The inflection point isn't a binary across your whole platform. It's a per-integration decision. Most production agents cross the line several times, and the protocol choice should change with it.
A Synergistic Future: Beyond Either/Or
The choice between MCP and CLI is not a zero-sum game. In fact, the most powerful and future-proof development environments will likely leverage both, recognizing their distinct strengths and allowing them to complement each other.
CLI for Agent Development and Tooling
The CLI will continue to be the primary interface for human developers building and managing the tools, infrastructure, and even the AI agents themselves. Consider these points:
- Building MCP Definitions: Developers will likely use CLI tools (perhaps extensions to existing spec tools) to create, validate, and manage MCP definitions for their APIs. This could involve commands to convert existing OpenAPI specs to MCP-ready formats, or to lint MCP definitions for compliance with essential security policies in MCP.
- Managing AI Agent Infrastructure: Deploying, monitoring, and scaling AI agents (which consume MCP-enabled APIs) will still be largely done through cloud CLIs (AWS, Azure, gcloud) and container orchestration CLIs (kubectl, Docker CLI).
- Testing and Debugging AI Interactions: While AI agents will consume MCP, human developers will need CLI tools to inspect logs, trigger specific API calls, and debug the agent's behavior during development.
- Version Control and Automation of MCP: Storing and versioning MCP definitions (e.g., in Git) will be managed via the Git CLI, and their integration into CI/CD pipelines will leverage traditional CLI scripting.
MCP for Agent Consumption and Intelligent API Interaction
Conversely, MCP will become the standard language for how AI agents communicate with APIs:
- AI-Driven API Consumption: Once an API is "MCP-ready," AI agents can independently discover, understand, and interact with it, abstracting away much of the manual integration effort currently required.
- Dynamic Workflow Generation: Instead of fixed scripts, AI agents can dynamically generate and execute workflows by interpreting MCP context, adapting to changing circumstances or new user requests.
- Enhanced API Visibility and Control for AI: MCP will allow for granular control over what an AI agent can do with an API, embedding rules for secure and compliant interactions directly into the machine-readable definitions. This will be an important feature for best API management platforms in the AI era.
The synergy lies in recognizing that CLIs empower the human developers who create and manage the intelligent systems, while MCP empowers the intelligent systems themselves to interact autonomously with the digital world. It's a powerful combination that pushes the boundaries of automation and intelligence, ensuring that both human ingenuity and machine capability are optimally utilized. For instance, CLIs might be used to monitor API usage metrics, complementing the MCP's role in guiding intelligent calls, as seen in API monitoring practices.
Preparing for an AI-First World: Making Your APIs MCP-Ready
As the influence of AI agents grows, preparing your API landscape for MCP isn't just a future-proofing measure; it's a strategic imperative. The transition requires a thoughtful approach to API design, documentation, and the tools you employ.
1. Understand the 'Why' of MCP
Before diving into implementation, grasp the core problem MCP solves: enabling reliable, intelligent, and autonomous API consumption by AI agents. This shift in perspective from human-centric to machine-centric API understanding is crucial for effective adoption.
2. Enrich API Specifications with Semantic Context
Move beyond basic OpenAPI definitions. Begin annotating your APIs with richer, machine-readable metadata. This includes:
- Purpose and Capabilities: Clearly define what an API does and what specific problems it solves.
- Input/Output Semantics: Use standardized vocabularies or ontologies to describe data types and their meanings, enabling AI to reason about data.
- Pre-conditions and Post-conditions: Specify what must be true before an API call and what will be true after, guiding agent decision-making.
- Side Effects: Document any non-obvious side effects of an API call, allowing agents to act responsibly.
- Usage Examples and Scenarios: Provide concrete examples of how an API is used in typical workflows, not just technical syntax.
Our guide on how to make your APIs MCP-ready offers a deeper dive into these requirements.
3. Implement Robust API Governance for AI
As AI agents gain autonomy, the need for robust governance intensifies. MCP definitions should incorporate policies and guardrails:
- Access Control for Agents: Define specific roles and permissions for AI agents, ensuring they only access authorized resources.
- Rate Limiting and Quotas: Implement mechanisms to prevent abuse by autonomous agents.
- Usage Monitoring and Auditing: Track how AI agents are interacting with your APIs for security and compliance.
These measures ensure that even autonomous interactions remain secure and compliant with organizational policies.
4. Adopt or Integrate with Platforms Supporting MCP
Look for API management platforms and developer portals that are evolving to support MCP. These platforms will provide tools to:
- Generate and Manage MCP Definitions: Tools to help convert existing OpenAPI specs or create new MCP artifacts.
- Publish MCP-Enabled APIs: Expose your enhanced APIs to an agent ecosystem.
- Monitor AI Agent Usage: Track the performance and behavior of AI agents consuming your APIs.
- Automate Documentation for AI: Automatically generate machine-readable documentation based on MCP principles.
Platforms like DigitalAPI are already focusing on bridging this gap, offering solutions for unified API management that accommodate both human developers and intelligent agents.
5. Cultivate an API-First Culture with AI in Mind
Shift your organizational mindset to view APIs not just as interfaces for human developers, but as fundamental building blocks for AI. This involves training developers in MCP principles, fostering collaboration between API teams and AI teams, and integrating MCP readiness into your overall API lifecycle management strategy.
By proactively embracing MCP, organizations can ensure their APIs remain relevant, discoverable, and intelligently consumable in an increasingly AI-driven world, unlocking new avenues for automation, innovation, and developer empowerment.
Conclusion
The evolution of developer tools reflects the changing demands of the software landscape. For decades, the Command Line Interface has been the undisputed champion for direct control, speed, and automation, empowering human developers with unparalleled precision. Its enduring relevance in scripting, system administration, and infrastructure management is a testament to its fundamental utility. However, the rapid ascent of artificial intelligence and the need for truly autonomous agents are ushering in a new era, one where the Model Context Protocol (MCP) will play an increasingly vital role.
MCP addresses the critical challenge of making APIs semantically understandable and safely consumable by AI agents, moving beyond human-centric documentation to structured, machine-readable context. It enables intelligent automation, dynamic discovery, and reliable interaction for AI systems, promising to unlock new levels of efficiency and innovation in API management.
Ultimately, the choice between MCP and CLI is not an either/or proposition but rather a recognition of distinct and complementary strengths. CLIs will continue to be the powerful interface for human developers to build, manage, and troubleshoot the underlying systems and even the AI agents themselves. MCP, in turn, will be the language through which these AI agents interact intelligently with the vast API ecosystem. The future of development lies in a synergistic approach, where organizations prepare their APIs to be "MCP-ready" while continuing to empower their human developers with the precision and flexibility of the CLI. Embracing both ensures a resilient, scalable, and intelligent software landscape ready for the next wave of technological advancement.
FAQs
1. What's the main difference between CLI and MCP for AI agents?
CLI gives an agent direct shell access to existing command-line tools, while MCP gives an agent a structured, schema-driven, multi-tenant-safe interface to tools, data, and prompts. CLI is cheaper and faster for single-user developer work; MCP is required for agents that act on behalf of other people's users.
2. Is MCP more expensive than CLI?
Yes, by a wide margin. The typical CLI command consumes around 200 tokens in context, while a typical MCP server injects 32,000 to 82,000 tokens of schema before the agent does any work. At 10,000 operations per month, public benchmarks show CLI costs around $3 vs MCP around $55 for equivalent tasks.
3. Why do LLMs perform better with CLI?
Frontier LLMs were trained on a Web full of CLI usage: Stack Overflow answers, GitHub READMEs, tutorials, blog posts. The model already knows git, kubectl, gh, docker, aws, and most other popular CLIs without needing a schema. MCP is newer, so the model has to read schemas at runtime instead of relying on training-time familiarity.
4. When does MCP make more sense than CLI?
When the agent acts on behalf of someone else, when no CLI exists for the target system, when you need per-user OAuth and structured audit trails, when you're serving multi-tenant customer workflows, when the work is regulated, or when the agent runs in the background without a human watching. Each of these breaks the assumptions a CLI session relies on.
5. Can AI agents use CLI tools directly?
Yes. Most modern coding agents and developer assistants execute CLI commands as subprocesses, observe the output, and iterate. This works extremely well for any tool the model already knows from training. It works less well for bespoke internal tools the model has never seen.
6. What is the "MCP Tax"?
The MCP Tax is the context window cost the model pays just to load an MCP server's tool definitions. Every tool, description, and JSON Schema goes into the conversation before the agent decides what to do. The result is 30,000-80,000 tokens of overhead per server before any productive work happens, which compounds across multiple servers and across long-running sessions.
7. Is MCP meant to replace REST APIs or OpenAPI?
No. MCP sits on top of APIs. Most production MCP servers wrap existing REST APIs and translate their OpenAPI definitions into MCP tools, resources, and prompts. The API is still the source of truth for the underlying capability; MCP is the structured interface AI agents use to discover and invoke it.
8. Is MCP meant to replace CLI?
No. The 2026 consensus is to use both, per integration. CLI for developer-owned, single-user, training-data-friendly workflows. MCP for multi-tenant, customer-facing, audit-sensitive workflows. The same agent can use both in the same session.
9. What is the difference between CLI, API, and MCP?
CLI is a shell program the agent invokes as a subprocess. API is an HTTP interface a service exposes. MCP is a protocol that wraps tools (often APIs) into a structured, multi-tenant-safe interface for AI consumption. CLI is fast and cheap for single-user work; API is for service-to-service integration; MCP is for AI agents that need governed access across many systems.
10. What are Skills, and how do they fit in?
Skills are lightweight, often markdown-based files that teach a model how to use an existing tool, usually a CLI. They typically run a few hundred to a few thousand tokens, dramatically less than an MCP schema. Public benchmarks have shown an 800-token Skills file describing gh usage outperforming a 28,000-token MCP schema for the same task. Skills augment CLI; they don't replace MCP for multi-tenant scenarios.
One email a fortnight. Worth opening.
A short digest of what we're writing, what we're learning from customers, and the handful of links you'd actually want from us. No tracking pixels.

.avif)
