Mainframe-mcp-server MCP Server

MCP server for IBM z/OS jobs, datasets, USS, and operational diagnostics via Zowe SDK.

Local serverstdio

What is the Mainframe-mcp-server MCP Server?

Mainframe-mcp-server is an MCP integration. MCP server for IBM z/OS jobs, datasets, USS, and operational diagnostics via Zowe SDK.

Packages and local setup

The published npm package is @notharshhaa/mainframe-mcp-server, version 2.5.0. Its declared MCP transport is stdio.

The package declares ZOSMF_HOST (required): z/OSMF hostname or IP address; ZOSMF_PORT: z/OSMF HTTPS port (default 443); ZOSMF_BASE_PATH: Optional API gateway or mediation layer prefix for z/OSMF; ZOSMF_USER: z/OS user id (required with ZOSMF_PASSWORD unless ZOSMF_TOKEN is set); ZOSMF_PASSWORD: Password for basic auth (required with ZOSMF_USER unless ZOSMF_TOKEN is set); ZOSMF_TOKEN: Auth token (alternative to user/password); ZOSMF_TOKEN_TYPE: Token type when using ZOSMF_TOKEN (e.g. LTPA2); ZOSMF_REJECT_UNAUTHORIZED: Verify TLS certificates (true in production); LOG_LEVEL: Log level: fatal, error, warn, info, debug, trace, silent; MCP_TRANSPORT: Transport: stdio (IDE) or sse (container/network); MCP_SSE_PORT: Listen port when MCP_TRANSPORT=sse; MAX_JOB_OUTPUT_LINES: Max lines returned from a single spool DD; MAX_DATASET_READ_LINES: Max lines returned from dataset or USS reads; MAX_JES_SPOOL_FILES: Max spool files fetched during diagnostics; MAX_AUDIT_LINES: Max RACF audit log lines per query; CMCI_CONTEXT: CICSplex name or region APPLID (required for CICS tools); CMCI_HOST: CMCI hostname (defaults to ZOSMF_HOST); CMCI_PORT: CMCI HTTPS port (default 1490); CMCI_BASE_PATH: CMCI REST base path; DB2_LOCATION: Db2 subsystem location name (required for Db2 tools); DB2_HOST: Db2 REST hostname (defaults to ZOSMF_HOST); DB2_PORT: Db2 REST port (default 50400); DB2_BASE_PATH: Db2 REST base path; SMF_SUMMARY_DATASET: Optional SMF summary dataset for offline metrics; RMF_METRICS_ENABLED: Query z/OSMF RMF metrics when available; RACF_AUDIT_USS_PATH: USS path to RACF audit log file; RACF_AUDIT_DATASET: Sequential dataset containing RACF audit records; SECURITY_READ_ONLY: When true, blocks write tools such as submit_jcl; SECURITY_ALLOWED_TOOLS: Comma-separated allowlist of MCP tool names; SECURITY_BLOCKED_TOOLS: Comma-separated blocklist of MCP tool names; SECURITY_ALLOWED_DATASET_PATTERNS: Comma-separated dataset patterns (e.g. USERDEV.,SYS1.); SECURITY_ALLOWED_USS_PATHS: Comma-separated USS path prefixes; SECURITY_AUDIT_LOGGING: Log every tool invocation to stderr (SIEM-friendly JSON); SECURITY_MAX_JCL_BYTES: Maximum inline JCL size for submit_jcl.

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository. This profile uses version 2.5.0 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related developer tools MCP servers for tools that cover the same kind of work.

Configuration

VariableDescriptionRequired
ZOSMF_HOSTz/OSMF hostname or IP addressYes
ZOSMF_PORTz/OSMF HTTPS port (default 443)Optional
ZOSMF_BASE_PATHOptional API gateway or mediation layer prefix for z/OSMFOptional
ZOSMF_USERz/OS user id (required with ZOSMF_PASSWORD unless ZOSMF_TOKEN is set)Optional
ZOSMF_PASSWORDPassword for basic auth (required with ZOSMF_USER unless ZOSMF_TOKEN is set)Optional
ZOSMF_TOKENAuth token (alternative to user/password)Optional
ZOSMF_TOKEN_TYPEToken type when using ZOSMF_TOKEN (e.g. LTPA2)Optional
ZOSMF_REJECT_UNAUTHORIZEDVerify TLS certificates (true in production)Optional
LOG_LEVELLog level: fatal, error, warn, info, debug, trace, silentOptional
MCP_TRANSPORTTransport: stdio (IDE) or sse (container/network)Optional
MCP_SSE_PORTListen port when MCP_TRANSPORT=sseOptional
MAX_JOB_OUTPUT_LINESMax lines returned from a single spool DDOptional
MAX_DATASET_READ_LINESMax lines returned from dataset or USS readsOptional
MAX_JES_SPOOL_FILESMax spool files fetched during diagnosticsOptional
MAX_AUDIT_LINESMax RACF audit log lines per queryOptional
CMCI_CONTEXTCICSplex name or region APPLID (required for CICS tools)Optional
CMCI_HOSTCMCI hostname (defaults to ZOSMF_HOST)Optional
CMCI_PORTCMCI HTTPS port (default 1490)Optional
CMCI_BASE_PATHCMCI REST base pathOptional
DB2_LOCATIONDb2 subsystem location name (required for Db2 tools)Optional
DB2_HOSTDb2 REST hostname (defaults to ZOSMF_HOST)Optional
DB2_PORTDb2 REST port (default 50400)Optional
DB2_BASE_PATHDb2 REST base pathOptional
SMF_SUMMARY_DATASETOptional SMF summary dataset for offline metricsOptional
RMF_METRICS_ENABLEDQuery z/OSMF RMF metrics when availableOptional
RACF_AUDIT_USS_PATHUSS path to RACF audit log fileOptional
RACF_AUDIT_DATASETSequential dataset containing RACF audit recordsOptional
SECURITY_READ_ONLYWhen true, blocks write tools such as submit_jclOptional
SECURITY_ALLOWED_TOOLSComma-separated allowlist of MCP tool namesOptional
SECURITY_BLOCKED_TOOLSComma-separated blocklist of MCP tool namesOptional
SECURITY_ALLOWED_DATASET_PATTERNSComma-separated dataset patterns (e.g. USERDEV.,SYS1.)Optional
SECURITY_ALLOWED_USS_PATHSComma-separated USS path prefixesOptional
SECURITY_AUDIT_LOGGINGLog every tool invocation to stderr (SIEM-friendly JSON)Optional
SECURITY_MAX_JCL_BYTESMaximum inline JCL size for submit_jclOptional