# MainframeKit

> MainframeKit is a free MCP server for developer tools. Checks JCL and DFSORT, explains abends and lays out copybooks, with no mainframe. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, Windows, macOS, Linux, vscode
- **Website:** https://mainframekit.com/ai/
- **MCP Registry name:** io.github.vidyutsaha1210/mainframekit
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

MainframeKit gives an assistant the rule-based checks that its website uses, so JCL or DFSORT that looks right but would fail can be caught before submitting a job. The server runs on your PC, makes no network requests while running and connects to no mainframe. The same input always gives the same answer, rules cite IBM documentation and simulations are labelled.

The lookup tool explains 185 abends, SQLCODEs and CICS, MQ and RACF security codes with causes, fixes and IBM sources. Copybook tools report the start, length and type of every field and the record length, and can decode a hex record against a copybook. Prompts are included for reviewing JCL, explaining an abend and building a sort step.

It is free to use for personal and work purposes on any number of machines, but all rights are reserved and the source is not published. It does not replace IBM or Broadcom tools, and the site advises confirming against IBM documentation before changing production.

## Features

- **JCL checking:** Finds common mistakes and explains every JOB, EXEC and DD statement in plain English.
- **DFSORT explanation:** Explains SORT, INCLUDE/OMIT, INREC/OUTREC and SUM statements and flags problems.
- **Code lookup:** Covers 185 abends, SQLCODEs and CICS, MQ and RACF codes with causes and fixes.
- **Copybook layout:** Lists start, length and type of each field and the record length.
- **Record decoding:** Decodes a hex record against a copybook, field by field.
- **Local and deterministic:** Runs on your PC with no network requests, giving the same output for the same input.

## Good for

- Check JCL an assistant wrote before submitting a job
- Find out why a batch job ended with S0C7
- Work out where a copybook field starts and the record length
- Decode a hex dump of a record
- Build and review a DFSORT step

## Install

### Claude Code (Terminal)

```sh
claude mcp add mainframekit -- npx -y mainframekit-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mainframekit": {
      "command": "npx",
      "args": [
        "-y",
        "mainframekit-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mainframekit": {
      "command": "npx",
      "args": [
        "-y",
        "mainframekit-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mainframekit": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mainframekit-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mainframekit": {
      "command": "npx",
      "args": [
        "-y",
        "mainframekit-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mainframekit": {
      "command": "npx",
      "args": [
        "-y",
        "mainframekit-mcp"
      ]
    }
  }
}
```

## Tools

- `check_jcl`: Finds common JCL mistakes and explains each statement.
- `explain_dfsort`: Explains DFSORT statements and flags problems.
- `lookup_code`: Explains abends, SQLCODEs and CICS, MQ and RACF codes.
- `copybook_layout`: Gives start, length and type of every copybook field.
- `decode_record`: Decodes a hex record against a copybook.

## FAQ

### Does it connect to a mainframe?

No. It connects to no mainframe and the server makes no network requests while running.

### Is it free?

Yes, free for personal and work use on any number of computers, but not open source and redistribution is not allowed.

### What do I need to run it?

Node.js 18 or later, started with npx -y mainframekit-mcp.

### Does my code leave my machine?

The server sends nothing, but your assistant's model provider still processes what you type under its own terms.

### Is MainframeKit free?

Yes. MainframeKit is free to use.

### How do I add MainframeKit to Claude Code?

Run this command in your terminal: claude mcp add mainframekit -- npx -y mainframekit-mcp

### What are the best alternatives to MainframeKit?

The closest alternatives to MainframeKit are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/mainframekit
