AI CLI MCP

🇯🇵 日本語のREADMEはこちら An MCP (Model Context Protocol) server that allows running AI CLI tools (Claude, Codex, Gemini, Forge, and OpenCode) in background processes with automatic permission handling. Its 8 documented tools cluster into read & search, claude, codex, gemini. It runs locally over stdio via the published package.

People connecting this server to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-07-21 · ★ 25 · #213 OF 848 MAINTAINED OTHER · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install AI CLI MCP

before you install - you'll need

CLAUDE_CLI_NAME, CODEX_CLI_NAME, OPENCODE_CLI_NAME, ACM_LIVE_E2E are optional or environment-specific per the README.

Claude Code

claude mcp add mkxultra-ai-cli-mcp -- npx -y ai-cli-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "mkxultra-ai-cli-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ai-cli-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package ai-cli-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.mkXultra is GitHub-verified and matches the repo owner

03 · What AI CLI MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can list all running and completed AI agent processes with their status, PID, and basic info, and get the current output and status of an AI agent process by PID.

Capability map

Tools grouped from the project's README - what AI CLI MCP lets an agent do.

read & search

2 tools - e.g. Lists all running and completed AI agent processes with their status, PID, and basic info.; Gets the current output and status of an AI agent process by PID.

list_processes · get_result

Claude

1 tool - e.g. sonnet, sonnet[1m], opus, opusplan, fable, haiku

Claude

Codex

1 tool - e.g. gpt-5.4, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.5, gpt-5.4-mini, gpt-5.3-codex, gpt-5.3-codex-spark, gpt-5.2

Codex

Gemini

1 tool - e.g. gemini-2.5-pro, gemini-2.5-flash, gemini-3.1-pro-preview, gemini-3-pro-preview, gemini-3-flash-preview

Gemini

Forge

1 tool - e.g. forge

Forge

Open Code

1 tool - e.g. opencode for the configured default backend model, plus explicit wrappers like oc-openai/gpt-5.4

OpenCode

Kill

1 tool - e.g. Terminates a running AI agent process by PID.

kill_process

Limitations (from the README)

Before the MCP server can use Claude, you must first run the Claude CLI manually once with the --dangerously-skip-permissions flag, login and accept the terms. Follow the prompts to accept. Once this is done, the MCP server will be able to use the flag non-interactively.

Latest releases

v2.22.0 · 2026-07-21

2.22.0 (2026-07-21) · add explicit Claude Fable model support · add GPT-5.6 Codex model family

v2.21.0 · 2026-04-23

2.21.0 (2026-04-23) · Codex モデルカタログを整理し gpt-5.4 をデフォルトに設定 · gpt-5.5 を Codex モデルに追加し codex-ultra エイリアスを更新

v2.20.1 · 2026-04-18

2.20.1 (2026-04-18) · shorten mcp registry description

04 · Who maintains AI CLI MCP

ai-cli-mcp is maintained by mkxultra. It's the only MCP server we track from this author; the repo dates to Jun 2025.

05 · Facts

repository: github.com/mkxultra/ai-cli-mcp
category: other - ranked #213 of 848 actively-maintained other servers as of 2026-08-25.
release cadence: 1 release in the last 90 days (latest 2026-07-21)
registry: io.github.mkXultra/ai-cli-mcp (active, first published 2026-03-02 · 17 versions)
packages: npm:ai-cli-mcp

06 · AI CLI MCP FAQ

Is AI CLI MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-07-21 and it shipped 1 release in the last 90 days. We re-verify nightly.

What can AI CLI MCP do?

With this server connected, an agent can list all running and completed AI agent processes with their status, PID, and basic info, and get the current output and status of an AI agent process by PID.

How do I install AI CLI MCP?

Run `npx -y ai-cli-mcp`. The README documents 4 environment variables (CLAUDE_CLI_NAME, CODEX_CLI_NAME, OPENCODE_CLI_NAME…) to set first. CLAUDE_CLI_NAME, CODEX_CLI_NAME, OPENCODE_CLI_NAME, ACM_LIVE_E2E are optional or environment-specific per the README. You can also paste the ready-made client config above.

Does AI CLI MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to AI CLI MCP

Alternatives to AI CLI MCP

Maintained other servers if AI CLI MCP isn't the fit.

More MCP servers to compare · Clipboard MCP · Molpha MCP · MolTrust MCP Server · Monday Com · MITRE ATT&CK

More TypeScript MCP servers · Scholar Sidekick · Agent Relay · DevPlan MCP Server · Mnemoverse Memory · Mobai MCP · see all