MCP server for IBM z/OS jobs, datasets, USS, and operational diagnostics via Zowe SDK.
To add mainframe-mcp-server to Claude, run the install command below or copy the ready-made config for Claude Code, Claude Desktop, Cursor and VS Code further down. Restart your client after adding it and its tools show up in your next conversation. It needs 50 environment variables, listed below.
Install
npx -y @notharshhaa/mainframe-mcp-server@3.0.0Environment variables
ZOSMF_HOSTSet in your MCP configZOSMF_PORTSet in your MCP configZOSMF_BASE_PATHSet in your MCP configZOSMF_USERSet in your MCP configZOSMF_PASSWORDSet in your MCP configZOSMF_TOKENSet in your MCP configZOSMF_TOKEN_TYPESet in your MCP configZOSMF_REJECT_UNAUTHORIZEDSet in your MCP configZOSMF_CERTSet in your MCP configZOSMF_CERT_KEYSet in your MCP configZOSMF_TOKEN_FILESet in your MCP configZOSMF_USER_IDSet in your MCP configZOSMF_PASSTICKET_APPSet in your MCP configZOWE_TEAM_CONFIGSet in your MCP configZOSMF_PROFILESet in your MCP configLOG_LEVELSet in your MCP configMCP_TRANSPORTSet in your MCP configMCP_SSE_PORTSet in your MCP configMAX_JOB_OUTPUT_LINESSet in your MCP configMAX_DATASET_READ_LINESSet in your MCP configMAX_JES_SPOOL_FILESSet in your MCP configMAX_AUDIT_LINESSet in your MCP configCMCI_CONTEXTSet in your MCP configCMCI_HOSTSet in your MCP configCMCI_PORTSet in your MCP configCMCI_BASE_PATHSet in your MCP configDB2_LOCATIONSet in your MCP configDB2_HOSTSet in your MCP configDB2_PORTSet in your MCP configDB2_BASE_PATHSet in your MCP configSMF_SUMMARY_DATASETSet in your MCP configRMF_METRICS_ENABLEDSet in your MCP configRACF_AUDIT_USS_PATHSet in your MCP configRACF_AUDIT_DATASETSet in your MCP configSECURITY_READ_ONLYSet in your MCP configSECURITY_ALLOWED_TOOLSSet in your MCP configSECURITY_BLOCKED_TOOLSSet in your MCP configSECURITY_ALLOWED_DATASET_PATTERNSSet in your MCP configSECURITY_ALLOWED_USS_PATHSSet in your MCP configSECURITY_AUDIT_LOGGINGSet in your MCP configSECURITY_MAX_JCL_BYTESSet in your MCP configSECURITY_WRITE_APPROVALSet in your MCP configSECURITY_JCL_SCANSet in your MCP configSECURITY_JCL_SCAN_STRICTSet in your MCP configSECURITY_BLOCKED_PROGRAMSSet in your MCP configSECURITY_BLOCKED_JOB_CLASSESSet in your MCP configSECURITY_CHANGE_TICKET_PATTERNSet in your MCP configSECURITY_WRITE_WINDOWSet in your MCP configSECURITY_WRITE_DAYSSet in your MCP configSECURITY_WRITE_WINDOW_TZSet in your MCP configInstall with your client
claude mcp add mainframe --env ZOSMF_HOST=<YOUR_ZOSMF_HOST> --env ZOSMF_PORT=<YOUR_ZOSMF_PORT> --env ZOSMF_BASE_PATH=<YOUR_ZOSMF_BASE_PATH> --env ZOSMF_USER=<YOUR_ZOSMF_USER> --env ZOSMF_PASSWORD=<YOUR_ZOSMF_PASSWORD> --env ZOSMF_TOKEN=<YOUR_ZOSMF_TOKEN> --env ZOSMF_TOKEN_TYPE=<YOUR_ZOSMF_TOKEN_TYPE> --env ZOSMF_REJECT_UNAUTHORIZED=<YOUR_ZOSMF_REJECT_UNAUTHORIZED> --env ZOSMF_CERT=<YOUR_ZOSMF_CERT> --env ZOSMF_CERT_KEY=<YOUR_ZOSMF_CERT_KEY> --env ZOSMF_TOKEN_FILE=<YOUR_ZOSMF_TOKEN_FILE> --env ZOSMF_USER_ID=<YOUR_ZOSMF_USER_ID> --env ZOSMF_PASSTICKET_APP=<YOUR_ZOSMF_PASSTICKET_APP> --env ZOWE_TEAM_CONFIG=<YOUR_ZOWE_TEAM_CONFIG> --env ZOSMF_PROFILE=<YOUR_ZOSMF_PROFILE> --env LOG_LEVEL=<YOUR_LOG_LEVEL> --env MCP_TRANSPORT=<YOUR_MCP_TRANSPORT> --env MCP_SSE_PORT=<YOUR_MCP_SSE_PORT> --env MAX_JOB_OUTPUT_LINES=<YOUR_MAX_JOB_OUTPUT_LINES> --env MAX_DATASET_READ_LINES=<YOUR_MAX_DATASET_READ_LINES> --env MAX_JES_SPOOL_FILES=<YOUR_MAX_JES_SPOOL_FILES> --env MAX_AUDIT_LINES=<YOUR_MAX_AUDIT_LINES> --env CMCI_CONTEXT=<YOUR_CMCI_CONTEXT> --env CMCI_HOST=<YOUR_CMCI_HOST> --env CMCI_PORT=<YOUR_CMCI_PORT> --env CMCI_BASE_PATH=<YOUR_CMCI_BASE_PATH> --env DB2_LOCATION=<YOUR_DB2_LOCATION> --env DB2_HOST=<YOUR_DB2_HOST> --env DB2_PORT=<YOUR_DB2_PORT> --env DB2_BASE_PATH=<YOUR_DB2_BASE_PATH> --env SMF_SUMMARY_DATASET=<YOUR_SMF_SUMMARY_DATASET> --env RMF_METRICS_ENABLED=<YOUR_RMF_METRICS_ENABLED> --env RACF_AUDIT_USS_PATH=<YOUR_RACF_AUDIT_USS_PATH> --env RACF_AUDIT_DATASET=<YOUR_RACF_AUDIT_DATASET> --env SECURITY_READ_ONLY=<YOUR_SECURITY_READ_ONLY> --env SECURITY_ALLOWED_TOOLS=<YOUR_SECURITY_ALLOWED_TOOLS> --env SECURITY_BLOCKED_TOOLS=<YOUR_SECURITY_BLOCKED_TOOLS> --env SECURITY_ALLOWED_DATASET_PATTERNS=<YOUR_SECURITY_ALLOWED_DATASET_PATTERNS> --env SECURITY_ALLOWED_USS_PATHS=<YOUR_SECURITY_ALLOWED_USS_PATHS> --env SECURITY_AUDIT_LOGGING=<YOUR_SECURITY_AUDIT_LOGGING> --env SECURITY_MAX_JCL_BYTES=<YOUR_SECURITY_MAX_JCL_BYTES> --env SECURITY_WRITE_APPROVAL=<YOUR_SECURITY_WRITE_APPROVAL> --env SECURITY_JCL_SCAN=<YOUR_SECURITY_JCL_SCAN> --env SECURITY_JCL_SCAN_STRICT=<YOUR_SECURITY_JCL_SCAN_STRICT> --env SECURITY_BLOCKED_PROGRAMS=<YOUR_SECURITY_BLOCKED_PROGRAMS> --env SECURITY_BLOCKED_JOB_CLASSES=<YOUR_SECURITY_BLOCKED_JOB_CLASSES> --env SECURITY_CHANGE_TICKET_PATTERN=<YOUR_SECURITY_CHANGE_TICKET_PATTERN> --env SECURITY_WRITE_WINDOW=<YOUR_SECURITY_WRITE_WINDOW> --env SECURITY_WRITE_DAYS=<YOUR_SECURITY_WRITE_DAYS> --env SECURITY_WRITE_WINDOW_TZ=<YOUR_SECURITY_WRITE_WINDOW_TZ> -- npx -y @notharshhaa/mainframe-mcp-server@3.0.0
Run this in a terminal to add the server to Claude Code.
What this does
mainframe-mcp-server exposes a set of tools to Claude over the Model Context Protocol. After you add it to claude_desktop_config.json (snippet above) and restart Claude Desktop, those tools become callable inside any conversation.
Requirements
This server needs the following environment variables to be set before it can run:
ZOSMF_HOST ZOSMF_PORT ZOSMF_BASE_PATH ZOSMF_USER ZOSMF_PASSWORD ZOSMF_TOKEN ZOSMF_TOKEN_TYPE ZOSMF_REJECT_UNAUTHORIZED ZOSMF_CERT ZOSMF_CERT_KEY ZOSMF_TOKEN_FILE ZOSMF_USER_ID ZOSMF_PASSTICKET_APP ZOWE_TEAM_CONFIG ZOSMF_PROFILE LOG_LEVEL MCP_TRANSPORT MCP_SSE_PORT MAX_JOB_OUTPUT_LINES MAX_DATASET_READ_LINES MAX_JES_SPOOL_FILES MAX_AUDIT_LINES CMCI_CONTEXT CMCI_HOST CMCI_PORT CMCI_BASE_PATH DB2_LOCATION DB2_HOST DB2_PORT DB2_BASE_PATH SMF_SUMMARY_DATASET RMF_METRICS_ENABLED RACF_AUDIT_USS_PATH RACF_AUDIT_DATASET SECURITY_READ_ONLY SECURITY_ALLOWED_TOOLS SECURITY_BLOCKED_TOOLS SECURITY_ALLOWED_DATASET_PATTERNS SECURITY_ALLOWED_USS_PATHS SECURITY_AUDIT_LOGGING SECURITY_MAX_JCL_BYTES SECURITY_WRITE_APPROVAL SECURITY_JCL_SCAN SECURITY_JCL_SCAN_STRICT SECURITY_BLOCKED_PROGRAMS SECURITY_BLOCKED_JOB_CLASSES SECURITY_CHANGE_TICKET_PATTERN SECURITY_WRITE_WINDOW SECURITY_WRITE_DAYS SECURITY_WRITE_WINDOW_TZ
Set these via the env object in your MCP config (see claude_desktop_config.json snippet above).
Frequently asked questions
How do I install mainframe-mcp-server?
Run the Claude Code command in the install section to add mainframe-mcp-server to Claude Code, or copy the ready-made config for your client from the install section on this page. Restart your client afterwards and the tools appear in your next conversation.
Which clients work with mainframe-mcp-server?
This page carries setup and config for Claude Code, Claude Desktop, Cursor and VS Code. Any other MCP client that accepts a standard server config can connect to mainframe-mcp-server as well.
Does mainframe-mcp-server need an API key?
Yes. Before it can run, set these environment variables: ZOSMF_HOST, ZOSMF_PORT, ZOSMF_BASE_PATH, ZOSMF_USER, ZOSMF_PASSWORD, ZOSMF_TOKEN, ZOSMF_TOKEN_TYPE, ZOSMF_REJECT_UNAUTHORIZED, ZOSMF_CERT, ZOSMF_CERT_KEY, ZOSMF_TOKEN_FILE, ZOSMF_USER_ID, ZOSMF_PASSTICKET_APP, ZOWE_TEAM_CONFIG, ZOSMF_PROFILE, LOG_LEVEL, MCP_TRANSPORT, MCP_SSE_PORT, MAX_JOB_OUTPUT_LINES, MAX_DATASET_READ_LINES, MAX_JES_SPOOL_FILES, MAX_AUDIT_LINES, CMCI_CONTEXT, CMCI_HOST, CMCI_PORT, CMCI_BASE_PATH, DB2_LOCATION, DB2_HOST, DB2_PORT, DB2_BASE_PATH, SMF_SUMMARY_DATASET, RMF_METRICS_ENABLED, RACF_AUDIT_USS_PATH, RACF_AUDIT_DATASET, SECURITY_READ_ONLY, SECURITY_ALLOWED_TOOLS, SECURITY_BLOCKED_TOOLS, SECURITY_ALLOWED_DATASET_PATTERNS, SECURITY_ALLOWED_USS_PATHS, SECURITY_AUDIT_LOGGING, SECURITY_MAX_JCL_BYTES, SECURITY_WRITE_APPROVAL, SECURITY_JCL_SCAN, SECURITY_JCL_SCAN_STRICT, SECURITY_BLOCKED_PROGRAMS, SECURITY_BLOCKED_JOB_CLASSES, SECURITY_CHANGE_TICKET_PATTERN, SECURITY_WRITE_WINDOW, SECURITY_WRITE_DAYS, SECURITY_WRITE_WINDOW_TZ. They go in the env block of your MCP config.
Imported from the Official MCP Registry. The details above come from the registry entry; the maker can claim this listing to correct them, add docs, and see its traffic.
Is this your MCP server?
Claim this listing to see its traffic, fix details yourself, and skip the review queue on future updates.
Add this badge to your README
Show visitors this server is listed in the ClaudeRules directory. The badge links straight to this listing.
[](https://clauderules.net/mcp/io-github-notharshhaa-mainframe-mcp-server)<a href="https://clauderules.net/mcp/io-github-notharshhaa-mainframe-mcp-server" target="_blank" rel="noopener noreferrer"><img src="https://clauderules.net/api/badge/io-github-notharshhaa-mainframe-mcp-server" alt="Listed on clauderules.net" /></a>More AI MCP servers
GitHub
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Serena MCP: the IDE for your agent
A powerful toolkit for coding, providing semantic retrieval and editing capabilities.
MCP Toolbox for Databases
MCP Toolbox for Databases enables your agent to connect to your database.
Figma-Context-MCP
Give your coding agent access to your Figma data. Implement designs in any framework in one-shot.