notharshhaa avatar

Mainframe Mcp Server

notharshhaa/mainframe-mcp-server

Bridges Claude to IBM mainframe environments through the Zowe SDK, letting you work with z/OS jobs, datasets, Unix System Services files, and run operational diagnostics without leaving your conversation. You get programmatic access to submit and monitor JCL jobs, read and write mainframe datasets, navigate USS directories, and pull system metrics. Reach for this when you need to automate mainframe operations, debug production issues, or build workflows that span modern APIs and legacy z/OS systems. Requires Zowe CLI configuration with your mainframe credentials and connection profiles.

tools
57
auth
Secret needed
transport
STDIO
env vars
24
last updated
Oct 25, 2026

Tools

57 tools

Public tool metadata for what this MCP can expose to an agent.

list_jobsList jobs by owner, prefix, or status

List jobs by owner, prefix, or status

No parameter schema in public metadata yet.

get_job_statusStatus and return code for a job

Status and return code for a job

No parameter schema in public metadata yet.

get_job_outputSpool inventory or DD content

Spool inventory or DD content

No parameter schema in public metadata yet.

submit_jclSubmit inline JCL — governed by pre-flight scan, change ticket, change window, and optional human approval

Submit inline JCL — governed by pre-flight scan, change ticket, change window, and optional human approval

No parameter schema in public metadata yet.

approve_writeExecute a pending JCL submission after human review (requires SECURITY_WRITE_APPROVAL=true)

Execute a pending JCL submission after human review (requires SECURITY_WRITE_APPROVAL=true)

No parameter schema in public metadata yet.

analyze_job_failureAbend code, failing step, and suggested fix

Abend code, failing step, and suggested fix

No parameter schema in public metadata yet.

get_job_jclRetrieve submitted JCL from job spool

Retrieve submitted JCL from job spool

No parameter schema in public metadata yet.

list_datasetsList datasets matching an HLQ pattern

List datasets matching an HLQ pattern

No parameter schema in public metadata yet.

read_datasetRead a sequential dataset or PDS member

Read a sequential dataset or PDS member

No parameter schema in public metadata yet.

search_datasetSearch datasets by pattern

Search datasets by pattern

No parameter schema in public metadata yet.

search_membersSearch or list PDS members

Search or list PDS members

No parameter schema in public metadata yet.

get_dataset_infoCatalog attributes without reading content

Catalog attributes without reading content

No parameter schema in public metadata yet.

list_uss_directoryList a USS directory

List a USS directory

No parameter schema in public metadata yet.

read_uss_fileRead a USS file

Read a USS file

No parameter schema in public metadata yet.

search_uss_filesSearch files under a USS path

Search files under a USS path

No parameter schema in public metadata yet.

find_failed_jobsFailed jobs in a time window

Failed jobs in a time window

No parameter schema in public metadata yet.

summarize_abendsAbend code breakdown across recent jobs

Abend code breakdown across recent jobs

No parameter schema in public metadata yet.

system_health_summaryActive, queued, and failed job snapshot

Active, queued, and failed job snapshot

No parameter schema in public metadata yet.

investigate_incidentFull incident bundle for a job

Full incident bundle for a job

No parameter schema in public metadata yet.

lookup_abend_codeAbend reference lookup (S0C7, S806, S222, S0C4, …)

Abend reference lookup (S0C7, S806, S222, S0C4, …)

No parameter schema in public metadata yet.

verify_zosmf_connectionTest z/OSMF connectivity and auth

Test z/OSMF connectivity and auth

No parameter schema in public metadata yet.

compare_jobsSide-by-side comparison of two jobs

Side-by-side comparison of two jobs

No parameter schema in public metadata yet.

get_user_jobs_summaryJob counts by status for an owner

Job counts by status for an owner

No parameter schema in public metadata yet.

list_cics_regionsList CICS regions via CMCI REST

List CICS regions via CMCI REST

No parameter schema in public metadata yet.

get_cics_region_statusStatus and attributes of a CICS region

Status and attributes of a CICS region

No parameter schema in public metadata yet.

list_cics_transactionsTransaction definitions in a region

Transaction definitions in a region

No parameter schema in public metadata yet.

get_cics_region_statsRegion statistics/attributes from the CMCI CICSRegion resource

Region statistics/attributes from the CMCI CICSRegion resource

No parameter schema in public metadata yet.

cics_newcopyNEWCOPY a program via CMCI action (CICS TS 5.6+)

NEWCOPY a program via CMCI action (CICS TS 5.6+)

No parameter schema in public metadata yet.

cics_disable_transactionDisable/enable a local transaction via CMCI SET action

Disable/enable a local transaction via CMCI SET action

No parameter schema in public metadata yet.

list_db2_subsystemsList Db2 locations via Db2 REST

List Db2 locations via Db2 REST

No parameter schema in public metadata yet.

search_db2_catalogRead-only catalog search (tables, views, aliases)

Read-only catalog search (tables, views, aliases)

No parameter schema in public metadata yet.

issue_console_commandMVS commands (D A,L, D GRS,RES=…) with follow-up message collection

MVS commands (D A,L, D GRS,RES=…) with follow-up message collection

No parameter schema in public metadata yet.

get_console_messagesOperations-log tail (SYSLOG-style console feed)

Operations-log tail (SYSLOG-style console feed)

No parameter schema in public metadata yet.

hold_jobJES2 $HJ job hold

JES2 $HJ job hold

No parameter schema in public metadata yet.

release_jobJES2 $OJ job release

JES2 $OJ job release

No parameter schema in public metadata yet.

cancel_jobCancel a job via the z/OSMF jobs API

Cancel a job via the z/OSMF jobs API

No parameter schema in public metadata yet.

get_wlm_statusD WLM display (service policy / resources)

D WLM display (service policy / resources)

No parameter schema in public metadata yet.

ims_commandIMS commands via the system console (/DIS ACTIVE, /DIS TRAN …)

IMS commands via the system console (/DIS ACTIVE, /DIS TRAN …)

No parameter schema in public metadata yet.

get_hsm_activityDFSMShsm recall/migration activity from the operations log

DFSMShsm recall/migration activity from the operations log

No parameter schema in public metadata yet.

analyze_logrecSubmit an EREP report against LOGREC and summarize error records

Submit an EREP report against LOGREC and summarize error records

No parameter schema in public metadata yet.

scheduler_job_statusControl-M / CA 7 / IBM WLS job status via their REST APIs (SCHEDULER_ADAPTERS)

Control-M / CA 7 / IBM WLS job status via their REST APIs (SCHEDULER_ADAPTERS)

No parameter schema in public metadata yet.

job_dependenciesJCL dataset-flow analysis — inputs, outputs, updates, PROCs

JCL dataset-flow analysis — inputs, outputs, updates, PROCs

No parameter schema in public metadata yet.

mq_queue_statusQueue curdepth vs maxdepth with high-water warnings

Queue curdepth vs maxdepth with high-water warnings

No parameter schema in public metadata yet.

mq_channel_statusChannel status (RUNNING/RETRYING/STOPPED) and connection counts

Channel status (RUNNING/RETRYING/STOPPED) and connection counts

No parameter schema in public metadata yet.

get_volume_spaceDASD volume space via z/OSMF SMI, with low-space alerts (STORAGE_FREE_THRESHOLD)

DASD volume space via z/OSMF SMI, with low-space alerts (STORAGE_FREE_THRESHOLD)

No parameter schema in public metadata yet.

get_job_capacityPer-step and total CPU from JESMSGLG (IEF374I/IEF376I) + MSU estimate (CAPACITY_MSU_RATING)

Per-step and total CPU from JESMSGLG (IEF374I/IEF376I) + MSU estimate (CAPACITY_MSU_RATING)

No parameter schema in public metadata yet.

estimate_mlc_costMLC cost attribution from CPU/MSU (MLC_MSU_MONTHLY_PRICE)

MLC cost attribution from CPU/MSU (MLC_MSU_MONTHLY_PRICE)

No parameter schema in public metadata yet.

summarize_dumpCEEDUMP / SYSMDUMP / SYSUDUMP digest — completion codes, failing module, LE conditions

CEEDUMP / SYSMDUMP / SYSUDUMP digest — completion codes, failing module, LE conditions

No parameter schema in public metadata yet.

get_smf_metricsSMF/RMF performance metrics snapshot

SMF/RMF performance metrics snapshot

No parameter schema in public metadata yet.

query_racf_auditQuery RACF audit records from a log source

Query RACF audit records from a log source

No parameter schema in public metadata yet.

security_posture_summaryReport active security controls and recommendations

Report active security controls and recommendations

No parameter schema in public metadata yet.

analyze_root_causeDeep root-cause analysis with correlation and action items

Deep root-cause analysis with correlation and action items

No parameter schema in public metadata yet.

predict_batch_failuresPredictive risk scoring for recurring batch failures

Predictive risk scoring for recurring batch failures

No parameter schema in public metadata yet.

list_environmentsNamed z/OS environments (DEV/TEST/UAT/PROD, LPARs) with per-environment read-only and role policy

Named z/OS environments (DEV/TEST/UAT/PROD, LPARs) with per-environment read-only and role policy

No parameter schema in public metadata yet.

whoamiActing identity, resolved role, permission summary, active environment, data-protection status

Acting identity, resolved role, permission summary, active environment, data-protection status

No parameter schema in public metadata yet.

create_incident_ticketRebuild the investigate_incident bundle for a job and file it as a ServiceNow incident, Jira issue, or PagerDuty incident

Rebuild the investigate_incident bundle for a job and file it as a ServiceNow incident, Jira issue, or PagerDuty incident

No parameter schema in public metadata yet.

search_internal_docsRetrieve the most relevant excerpts from internal documentation, with file and heading attribution

Retrieve the most relevant excerpts from internal documentation, with file and heading attribution

No parameter schema in public metadata yet.

Sponsors

Configuration

ZOSMF_HOST*

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_PASSWORDsecret

Password for basic auth (required with ZOSMF_USER unless ZOSMF_TOKEN is set)

ZOSMF_TOKENsecret

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)

ZOSMF_CERT

PEM client certificate file path for mTLS auth

ZOSMF_CERT_KEY

PEM client key file path for mTLS auth (required with ZOSMF_CERT)

ZOSMF_TOKEN_FILE

Read ZOSMF_TOKEN from this file at startup (vault/agent injection)

ZOSMF_USER_ID

End-user id for PassTicket identity propagation (RACF sees this user, not the service account)

ZOSMF_PASSTICKET_APP

RACF PTKTDATA application name for PassTicket generation (default ZOSMF)

ZOWE_TEAM_CONFIG

Path to a zowe.config.json to import connection settings from (env vars win)

ZOSMF_PROFILE

Profile name inside the Zowe team config (defaults to defaults.zosmf)

LOG_LEVEL

Log level: fatal, error, warn, info, debug, trace, silent

MCP_TRANSPORT

Transport: stdio (IDE) or sse (legacy HTTP+SSE for container/network deployments)

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)

Readme

mainframe-mcp-server

MCP Server for IBM z/OS using Zowe APIs


View the full README on GitHub

Details

Repository
github.com/notharshhaa/mainframe-mcp-server
Package
@notharshhaa/mainframe-mcp-server
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from notharshhaa