IAF Agent Bridge MCP server

IAF Agent Bridge

MCP server that lets Codex, Claude Code, or another stdio host send work to Cursor Agent and continue the same Cursor session until the requested work is done.

The bridge carries the prompt, the session, and Cursor's reply. The supervisor decides what happens next. Cursor does the implementation.

delegate returns only after that Cursor turn is finished. A message that says the work is complete does not end the call while Cursor is still running tools, sub-agents, or a follow-up. Cursor keeps control of that internal work. The supervisor sees one result, then chooses CONTINUE, COMPLETE, or BLOCKED.

Status: npm iaf-agent-bridge@1.0.2 is the current public package. GitHub Release v1.0.2 matches it. v1.0.1 and v1.0.0 remain published. The Official MCP Registry entry is io.github.francescoveryra-dot/iaf-agent-bridge version 1.0.2.

Supervisor (Codex, Claude Code, or another MCP host)
        |
        | MCP over stdio
        v
IAF Agent Bridge
        |
        | ACP over stdio
        v
Cursor Agent
        |
        v
Your repository

Cursor Agent is the only production executor. Codex and Claude Code are supervisors. Do not install this server into the Cursor MCP config of a repository that Cursor itself is editing. That loop is refused.

What you can do

• Start a Cursor session from an MCP host and resume it with sessionId.
• Let ordinary development continue without approving every tool call.
• Reject force-push, history rewrite, destructive SQL, deletes outside the project, and secret staging unless you explicitly set IAFPERMISSIONMODE=allow-all.
• Use a Master Prompt when the repository has one. A repository without one works normally.

Prerequisites

• Node.js 20 or newer. Running the test suite needs Node.js 22.
• The Cursor CLI on your PATH as agent.
• agent login completed on that machine.

No OpenAI API key is required.

Install

Shortened. The full README is on GitHub.