Skip to main content
MCP server CX Codex

Zcrafter Bridge — Claude Code MCP server: features and setup

Zcrafter Bridge is an MCP server for Claude Code that connects an AI agent to IBM z/OS. It can read mainframe data, while a person must approve changes.

MIT ★ 5 updated 2026-11-16

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add --env MAINFRAME_WORKFLOW_ZOWE_PROFILE=<MAINFRAME_WORKFLOW_ZOWE_PROFILE> --env ZOWE_OPT_HOST=<ZOWE_OPT_HOST> --env ZOWE_OPT_USER=<ZOWE_OPT_USER> --env ZOWE_OPT_PASSWORD=<ZOWE_OPT_PASSWORD> --env MAINFRAME_WORKFLOW_READ_ONLY=<MAINFRAME_WORKFLOW_READ_ONLY> --transport stdio zcrafter-bridge -- uvx zcrafter-bridge
Open on GitHub

What Zcrafter Bridge does

Zcrafter Bridge gives an agent tools for datasets and PDS members, z/OS UNIX files, batch jobs, spool, TSO, and the operator console. It connects through z/OSMF and the Zowe SDK; nothing needs to be installed on the mainframe.

Read operations need no approval. To write data, submit a job, run a command, or delete a dataset, the agent must first request approval for a specification and a plan listing the permitted steps. Only a person can approve it, through the client, a browser page, or zcrafter-bridge approve in a terminal.

Running the server requires Python 3.11 or newer and z/OSMF credentials. Supply ZOWE_OPT_HOST, ZOWE_OPT_USER, and ZOWE_OPT_PASSWORD, or use a Zowe profile. Bridge does not store the password or send it to the AI model.

What it helps with

  • read a COBOL member from a dataset
  • find failed jobs and inspect their output
  • change JCL only after a person approves the plan
  • check the connection to z/OSMF

Example prompts for the agent

  • Read PAY.TEST.COBOL(PAYCALC) and explain its contents.
  • Find jobs that ended with errors and show their output.
  • Draft a plan for changing this JCL, then wait for my approval.

How to install Zcrafter Bridge

Platform CLI

claude mcp add --env MAINFRAME_WORKFLOW_ZOWE_PROFILE=<MAINFRAME_WORKFLOW_ZOWE_PROFILE> --env ZOWE_OPT_HOST=<ZOWE_OPT_HOST> --env ZOWE_OPT_USER=<ZOWE_OPT_USER> --env ZOWE_OPT_PASSWORD=<ZOWE_OPT_PASSWORD> --env MAINFRAME_WORKFLOW_READ_ONLY=<MAINFRAME_WORKFLOW_READ_ONLY> --transport stdio zcrafter-bridge -- uvx zcrafter-bridge

Replace <…> with your own values. 1 more environment variable is in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from zcrafter-bridge <command>

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Zcrafter Bridge

How do I install Zcrafter Bridge in Claude Code?

Add it with claude mcp add bridge -e ZOWE_OPT_PASSWORD=<ZOWE_OPT_PASSWORD> -- uvx zcrafter-bridge. The connection also needs z/OSMF credentials.

What does Zcrafter Bridge do?

It connects an AI agent to IBM z/OS for reading mainframe data and working with jobs, files, and commands. A person must approve a plan before any changes run.

What does Zcrafter Bridge require?

It needs Python 3.11 or newer, access to z/OSMF, and credentials supplied through ZOWE_OPT_HOST, ZOWE_OPT_USER, and ZOWE_OPT_PASSWORD, or a Zowe profile.

Similar MCP servers

MCP servers catalog →

Project sponsors

Companies that keep this analytics open