mainframe-mcp-server

{
  "name": "io.github.NotHarshhaa/mainframe-mcp-server",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "version": "2.5.0",
  "packages": [
    {
      "version": "2.5.0",
      "transport": {
        "type": "stdio"
      },
      "identifier": "@notharshhaa/mainframe-mcp-server",
      "registryType": "npm",
      "environmentVariables": [
        {
          "name": "ZOSMF_HOST",
          "format": "string",
          "isRequired": true,
          "description": "z/OSMF hostname or IP address"
        },
        {
          "name": "ZOSMF_PORT",
          "format": "number",
          "description": "z/OSMF HTTPS port (default 443)"
        },
        {
          "name": "ZOSMF_BASE_PATH",
          "format": "string",
          "description": "Optional API gateway or mediation layer prefix for z/OSMF"
        },
        {
          "name": "ZOSMF_USER",
          "format": "string",
          "description": "z/OS user id (required with ZOSMF_PASSWORD unless ZOSMF_TOKEN is set)"
        },
        {
          "name": "ZOSMF_PASSWORD",
          "format": "string",
          "isSecret": true,
          "description": "Password for basic auth (required with ZOSMF_USER unless ZOSMF_TOKEN is set)"
        },
        {
          "name": "ZOSMF_TOKEN",
          "format": "string",
          "isSecret": true,
          "description": "Auth token (alternative to user/password)"
        },
        {
          "name": "ZOSMF_TOKEN_TYPE",
          "format": "string",
          "description": "Token type when using ZOSMF_TOKEN (e.g. LTPA2)"
        },
        {
          "name": "ZOSMF_REJECT_UNAUTHORIZED",
          "format": "boolean",
          "description": "Verify TLS certificates (true in production)"
        },
        {
          "name": "LOG_LEVEL",
          "format": "string",
          "description": "Log level: fatal, error, warn, info, debug, trace, silent"
        },
        {
          "name": "MCP_TRANSPORT",
          "format": "string",
          "description": "Transport: stdio (IDE) or sse (container/network)"
        },
        {
          "name": "MCP_SSE_PORT",
          "format": "number",
          "description": "Listen port when MCP_TRANSPORT=sse"
        },
        {
          "name": "MAX_JOB_OUTPUT_LINES",
          "format": "number",
          "description": "Max lines returned from a single spool DD"
        },
        {
          "name": "MAX_DATASET_READ_LINES",
          "format": "number",
          "description": "Max lines returned from dataset or USS reads"
        },
        {
          "name": "MAX_JES_SPOOL_FILES",
          "format": "number",
          "description": "Max spool files fetched during diagnostics"
        },
        {
          "name": "MAX_AUDIT_LINES",
          "format": "number",
          "description": "Max RACF audit log lines per query"
        },
        {
          "name": "CMCI_CONTEXT",
          "format": "string",
          "description": "CICSplex name or region APPLID (required for CICS tools)"
        },
        {
          "name": "CMCI_HOST",
          "format": "string",
          "description": "CMCI hostname (defaults to ZOSMF_HOST)"
        },
        {
          "name": "CMCI_PORT",
          "format": "number",
          "description": "CMCI HTTPS port (default 1490)"
        },
        {
          "name": "CMCI_BASE_PATH",
          "format": "string",
          "description": "CMCI REST base path"
        },
        {
          "name": "DB2_LOCATION",
          "format": "string",
          "description": "Db2 subsystem location name (required for Db2 tools)"
        },
        {
          "name": "DB2_HOST",
          "format": "string",
          "description": "Db2 REST hostname (defaults to ZOSMF_HOST)"
        },
        {
          "name": "DB2_PORT",
          "format": "number",
          "description": "Db2 REST port (default 50400)"
        },
        {
          "name": "DB2_BASE_PATH",
          "format": "string",
          "description": "Db2 REST base path"
        },
        {
          "name": "SMF_SUMMARY_DATASET",
          "format": "string",
          "description": "Optional SMF summary dataset for offline metrics"
        },
        {
          "name": "RMF_METRICS_ENABLED",
          "format": "boolean",
          "description": "Query z/OSMF RMF metrics when available"
        },
        {
          "name": "RACF_AUDIT_USS_PATH",
          "format": "string",
          "description": "USS path to RACF audit log file"
        },
        {
          "name": "RACF_AUDIT_DATASET",
          "format": "string",
          "description": "Sequential dataset containing RACF audit records"
        },
        {
          "name": "SECURITY_READ_ONLY",
          "format": "boolean",
          "description": "When true, blocks write tools such as submit_jcl"
        },
        {
          "name": "SECURITY_ALLOWED_TOOLS",
          "format": "string",
          "description": "Comma-separated allowlist of MCP tool names"
        },
        {
          "name": "SECURITY_BLOCKED_TOOLS",
          "format": "string",
          "description": "Comma-separated blocklist of MCP tool names"
        },
        {
          "name": "SECURITY_ALLOWED_DATASET_PATTERNS",
          "format": "string",
          "description": "Comma-separated dataset patterns (e.g. USERDEV.*,SYS1.*)"
        },
        {
          "name": "SECURITY_ALLOWED_USS_PATHS",
          "format": "string",
          "description": "Comma-separated USS path prefixes"
        },
        {
          "name": "SECURITY_AUDIT_LOGGING",
          "format": "boolean",
          "description": "Log every tool invocation to stderr (SIEM-friendly JSON)"
        },
        {
          "name": "SECURITY_MAX_JCL_BYTES",
          "format": "number",
          "description": "Maximum inline JCL size for submit_jcl"
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/NotHarshhaa/mainframe-mcp-server",
    "source": "github"
  },
  "description": "MCP server for IBM z/OS jobs, datasets, USS, and operational diagnostics via Zowe SDK."
}