MCP SERVER FOR IBM z/OS

Let AI agents work on z/OS, safely.

Envoy is an MCP server that gives AI agents tools for CICS, Db2, IBM MQ, IMS, JES, data sets, z/OS UNIX files, RACF and the system console. Every call runs as the real caller, is authorised by RACF, and is audited.

Runs as the real caller RACF authorises every tool Every call audited Read-only by default

WHAT AGENTS CAN REACH

One MCP server for the whole of z/OS

Agents call tools over the Model Context Protocol, and Envoy reaches the subsystems behind them.

  • CICS
  • Db2
  • IBM MQ
  • IMS
  • JES jobs and spool
  • Data sets
  • z/OS UNIX files
  • RACF
  • System console

SAFE BY DESIGN

The mainframe's own security, on every call

The real caller, every time

Identity comes from a z/OSMF token. Each call runs as the user who made it, and RACF decides which tools that user may use.

Read-only by default

Write tools exist only when switched on for a subsystem, are fenced to named resources, and need confirm: true on every call.

Every call audited

Every tool call is audited, so anything an agent did on the mainframe can be traced to the user it ran as.

Refusals that teach

A refused call says what was wrong and what a correct call looks like, so agents learn the boundary instead of guessing at it.

Requestdisplay_command
{ "command": "D U,VOL=CPTVS1" }
Envoy's replyNOT_AUTHORIZED
NOT_AUTHORIZED: Command 'D U,VOL=CPTVS1' is not in the console allow-list. Permitted: D T, D IPLINFO, D A,L, D A,LIST, D M=CPU, D SYMBOLS, D PARMLIB, D SMF, D OMVS,*, D TCPIP,*
A real refused call on z/OS 3.2, 5 October 2026: Envoy names what it refused and lists what is allowed.

PLUG-IN DESIGN

One vocabulary for every subsystem

Each subsystem is a plug-in behind one versioned SPI. Four shared tools (list_subsystems, subsystem_status, list_resources and describe_resource) work the same way everywhere, so a new subsystem adds no new tool names.

list_subsystemssubsystem_statuslist_resourcesdescribe_resource
45tools
8subsystem plug-ins
4shared tools

Running on z/OS 3.2

Verified on z/OS 3.2 (ZD&T) since 4 October 2026. Built with Java 21, embedded Jetty and the MCP Java SDK.

ENTERPRISE PILOT & CONSULTATION

Modernize Your Core Systems With Confidence.

Book a technical consultation, or ask for a pilot license of AnikaZEE Terminal.

[email protected]Book Consultation

Tell us about your platform, goals, and deployment requirements.

IBM Z / IBM i · AnikaZEE · Envoy