Skip to main content
Agents can use Caesar through the CLI, the remote MCP server, or both. If the agent has shell access, start with the CLI. Use MCP when the client is built around remote tools or cannot run local commands. Caesar’s MCP server is intentionally small: two tools, caesar_search and caesar_read. That keeps its schema cost bounded. The broader MCP vs CLI tradeoff still matters when an agent session loads many MCP servers: tool schemas compete with task context, while CLI access is more progressive — the agent sees a short instruction, runs a command, and only then receives output.

​
Quick answer

ChooseWhenWhy
CLIThe agent has shell access, can write files, or runs in CILowest context overhead, explicit exit codes, --json, and -o file capture for large outputs
MCPThe agent runs in a chat or IDE client with remote tool supportNo local binary, discoverable tools, structured calls, and centralized auth
BothThe agent can use tools and shell commandsMCP gives easy interactive access; CLI handles scripts, artifacts, and repeatable automation
For Claude Code and other coding agents with a shell, start with the CLI or the Caesar skill. For Cursor, Windsurf, and chat clients that already manage MCP servers, start with MCP.

​
What changes for the agent

CLI

The agent runs caesar-search, reads stdout/stderr, checks exit codes, and can save JSON to files with -o.

MCP

The client connects to Caesar’s remote server and exposes caesar_search and caesar_read as structured tools.

​
Use the CLI when

  • The agent can run shell commands.
  • You want a lean prompt: a short skill or instruction can teach the command without loading tool schemas into every turn.
  • You want deterministic scripting behavior: exit codes, stderr error envelopes, and --json output.
  • Large search results should be written to a file instead of pasted into the chat context.
  • The workflow is part of CI, a local script, or a repeatable terminal task.
  • You want the same commands a human can run and debug.
  • You want to restrict the agent’s tool surface by documenting only the commands it should use.
Start here:

Install the CLI

Install caesar-search with Homebrew, npm, or the standalone installer.

CLI usage

Search, read, feedback, JSON output, and exit codes.

Scripting and CI

Use caesar-search in scripts, schedulers, and CI pipelines.

​
Use MCP when

  • The agent client already supports remote MCP tools.
  • You want a no-binary setup for a chat or IDE assistant.
  • The client should discover the available Caesar tools instead of being prompted with shell commands.
  • Auth should live in the MCP client configuration.
  • The workflow is interactive and only needs search and read.
  • The agent does not have a shell, or shell access is intentionally disabled.
MCP exposes exactly two Caesar tools: caesar_search and caesar_read. Feedback is REST, CLI, and SDK only.

Remote MCP server

Connect any MCP client to Caesar’s hosted streamable-HTTP server.

​
Use both when

Many agent setups benefit from both surfaces:
  • MCP for quick interactive search and read inside the client.
  • CLI for scripted runs, saved JSON artifacts, and commands the agent can replay outside the chat.
  • Skills for coding agents that need durable instructions about when to choose each path.
The Caesar skill uses the CLI when available because shell agents handle command output and files well. MCP remains the better first choice for clients whose native integration model is remote tools.

​
Keep the tool surface lean

For shell-capable agents, a small instruction file plus the CLI is often enough: 
Use caesar-search for web search and document reads.
Prefer --json for machine output.
Use -o for large responses.
Never pass literal API keys; use CAESAR_API_KEY.
That is the Caesar version of progressive disclosure: document the command and constraints, then let the agent call the tool when the task needs it. Avoid giving an agent every possible surface at once. If the agent only needs search and read, install the Caesar skill or CLI; add MCP only when the client benefits from remote tool discovery.

​
Decision checklist

QuestionLean CLILean MCP
Does the agent have shell access?yesno
Does the workflow need -o files or CI artifacts?yesno
Does the client already manage MCP servers?optionalyes
Does the workflow need only search and read?eitheryes
Does it need CLI-style automation, exit codes, or raw API escape hatches?yesno
Is the session already loaded with many MCP servers?yesno
Do you need dynamic tool discovery?noyes

​
External context

The broader MCP vs CLI discussion usually lands on a practical split: CLI is strongest for lean local or scripted work, MCP is strongest for structured remote tool access in clients that support it, and mature agent setups often use both. Recent critiques of MCP make the context-cost point more forcefully; for Caesar, that means defaulting shell agents to the CLI while keeping the small remote MCP server available for MCP-native clients.