run

MCP tool from Ai Cli MCP by mkXultra

Executes a prompt using Claude CLI, Codex CLI, Gemini CLI, Forge CLI, or OpenCode. The appropriate CLI is automatically selected based on the model name.

How to use it

Project documentation lists run for the Ai Cli MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), then check which tools your installed version makes available. Tool availability can depend on configuration and credentials. A server handshake does not verify this tool’s behavior. See the full listing for setup details.

Install Ai Cli MCP

$claude mcp add ai-cli '{"name":"ai-cli","command":"npx","args":["-y","ai-cli-mcp@latest"]}'

FULL AI CLI MCP LISTING

Other tools in Ai Cli MCP (7)

doctor

Checks supported AI CLI binary availability and path resolution from MCP clients. Like ai-cli doctor, it returns a checks block and does not verify login state or terms acceptance.

get_result

Gets the current output and status of an AI agent process by PID.

kill_process

Terminates a running AI agent process by PID.

list_processes

Lists all running and completed AI agent processes with their status, PID, and basic info.

models

Lists supported model names, aliases, and dynamic backend discovery hints from MCP clients. This returns the same structured payload as ai-cli models.

peek

Starts a one-shot short observation window for running child agents and returns structured events observed during that specific call. By default this includes only natural-language message events; pass includetoolcalls or --include-tool-calls to also include normalized tool-call events. It is not a

wait

Waits for multiple AI agent processes to complete and returns their combined results. Blocks until all specified PIDs finish or a timeout occurs.