Ai Intervention Agent MCP Server

AI Intervention Agent monorepo root: aggregates the PyPI MCP server, the VS Code / Open VSX extension under packages/vscode, and Web UI tooling.

Local serverstdioPython

What is the Ai Intervention Agent MCP server?

If you already use Ai Intervention Agent, the ai intervention agent mcp server is the piece that lets your assistant work with it directly. AI Intervention Agent monorepo root: aggregates the PyPI MCP server, the VS Code / Open VSX extension under packages/vscode, and Web UI tooling. private:true; never published to npm.

What the server does

Real-time user intervention for MCP agents — pause, course-correct, resume.

  • Real-time intervention — — the agent pauses and waits for your input via interactive_feedback
  • Web UI — — Markdown, code highlighting, and math rendering out of the box
  • Multi-task tabs — — concurrent requests with independent countdowns, per-task draft autosave, and auto re-submit that keeps long sessions alive (your typed text and checked options are submitted at zero, never an empty prompt)
  • Typing-hold — — the countdown auto-extends while you type and never fires mid-input (web page and VS Code extension alike)
  • Agent-loop ergonomics — — per-task header_label context chips, question_type='yesno' one-click decisions, and feedback_placeholder hints
  • Notifications — — web / sound / system / Bark (iOS push), plus custom notification sound upload

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • command — uvx
  • args — ["ai-intervention-agent"]
  • timeout — 600
  • autoApprove — ["interactive_feedback"]
  • Real — time intervention** — the agent pauses and waits for your input via interactive_feedback
  • Multi — task tabs** — concurrent requests with independent countdowns, per-task draft autosave, and auto re-submit that keeps long sessions alive (your typed
  • Typing-hold — the countdown auto-extends while you type and never fires mid-input (web page and VS Code extension alike)
  • Agent — loop ergonomics** — per-task header_label context chips, question_type='yesno' one-click decisions, and feedback_placeholder hints
  • Notifications — web / sound / system / Bark (iOS push), plus custom notification sound upload
  • i18n — Web UI + VS Code extension shipped in en / zh-CN / zh-TW
  • More — ai-intervention-agent.logLevel, macOS native notifications (on by default, toggle in the sidebar's Notification Settings panel) — full settings list
  • ContributingCONTRIBUTING.md · CODE_OF_CONDUCT.md · scripts index: scripts/README.md

Credentials and setup notes

Configuration is passed through the environment: AI_INTERVENTION_AGENT_WEB_UI_HOST, AI_INTERVENTION_AGENT_WEB_UI_PORT, AI_INTERVENTION_AGENT_WEB_UI_LANGUAGE. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Installation

The server ships on PyPI as ai-intervention-agent, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Where it fits

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Ai Intervention Agent's toolset — command, args, timeout and 11 more — is a fair guide to whether it matches your workflow. It is maintained by XIADENGMA; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Ai Intervention Agent's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Ai Intervention Agent.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
commanduvx
args["ai-intervention-agent"]
timeout600
autoApprove["interactive_feedback"]
Realtime intervention** — the agent pauses and waits for your input via interactive_feedback
Multitask tabs** — concurrent requests with independent countdowns, per-task draft autosave, and auto re-submit that keeps long sessions alive (your typed text and checked options are submitted at zero, never an empty prompt)
Typing-holdthe countdown auto-extends while you type and never fires mid-input (web page and VS Code extension alike)
Agentloop ergonomics** — per-task header_label context chips, question_type='yesno' one-click decisions, and feedback_placeholder hints
Notificationsweb / sound / system / Bark (iOS push), plus custom notification sound upload
i18nWeb UI + VS Code extension shipped in en / zh-CN / zh-TW
Moreai-intervention-agent.logLevel, macOS native notifications (on by default, toggle in the sidebar's Notification Settings panel) — full settings list and the AppleScript executor security model in [packages/vscode/README.
Contributing[CONTRIBUTING.md](.github/CONTRIBUTING.md) · [CODE_OF_CONDUCT.md](.github/CODE_OF_CONDUCT.md) · scripts index: [scripts/README.md](scripts/README.md) · i18n guide: [docs/i18n.md](docs/i18n.md)
Linux~/.config/ai-intervention-agent/
macOS~/Library/Application Support/ai-intervention-agent/

How to install the Ai Intervention Agent MCP server

{
  "mcpServers": {
    "ai-intervention-agent": {
      "command": "uvx",
      "args": ["ai-intervention-agent"],
      "timeout": 600,
      "autoApprove": ["interactive_feedback"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
AI_INTERVENTION_AGENT_WEB_UI_HOSTEndpoint or connection string the server talks to.Optional
AI_INTERVENTION_AGENT_WEB_UI_PORTConfiguration value read at startup.Optional
AI_INTERVENTION_AGENT_WEB_UI_LANGUAGEConfiguration value read at startup.Optional

Example prompts to try

  • Use Ai Intervention Agent to command.
  • Use Ai Intervention Agent to args.
  • Use Ai Intervention Agent to timeout.

Frequently asked questions

It connects Ai Intervention Agent to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (command, args, timeout, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Ai Intervention Agent directly.