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
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-bridgeWhat 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-bridgeReplace <…> 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>
Platform CLI
codex mcp add zcrafter-bridge --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> -- uvx zcrafter-bridgeReplace <…> 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>
Config file
{
"mcpServers": {
"zcrafter-bridge": {
"command": "uvx",
"args": [
"zcrafter-bridge"
],
"env": {
"MAINFRAME_WORKFLOW_ZOWE_PROFILE": "<MAINFRAME_WORKFLOW_ZOWE_PROFILE>",
"ZOWE_OPT_HOST": "<ZOWE_OPT_HOST>",
"ZOWE_OPT_USER": "<ZOWE_OPT_USER>",
"ZOWE_OPT_PASSWORD": "<ZOWE_OPT_PASSWORD>",
"MAINFRAME_WORKFLOW_READ_ONLY": "<MAINFRAME_WORKFLOW_READ_ONLY>"
}
}
}
}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>
Config file
{
"servers": {
"zcrafter-bridge": {
"type": "stdio",
"command": "uvx",
"args": [
"zcrafter-bridge"
],
"env": {
"MAINFRAME_WORKFLOW_ZOWE_PROFILE": "<MAINFRAME_WORKFLOW_ZOWE_PROFILE>",
"ZOWE_OPT_HOST": "<ZOWE_OPT_HOST>",
"ZOWE_OPT_USER": "<ZOWE_OPT_USER>",
"ZOWE_OPT_PASSWORD": "<ZOWE_OPT_PASSWORD>",
"MAINFRAME_WORKFLOW_READ_ONLY": "<MAINFRAME_WORKFLOW_READ_ONLY>"
}
}
}
}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>
Platform CLI
gemini mcp add -e MAINFRAME_WORKFLOW_ZOWE_PROFILE=<MAINFRAME_WORKFLOW_ZOWE_PROFILE> -e ZOWE_OPT_HOST=<ZOWE_OPT_HOST> -e ZOWE_OPT_USER=<ZOWE_OPT_USER> -e ZOWE_OPT_PASSWORD=<ZOWE_OPT_PASSWORD> -e MAINFRAME_WORKFLOW_READ_ONLY=<MAINFRAME_WORKFLOW_READ_ONLY> zcrafter-bridge uvx zcrafter-bridgeReplace <…> 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.