skills.rest
gtwatts
gtwattsCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

mainframe-bash

Expose Mainframe functions to Claude Code via a JSON-RPC 2.0 server over stdin/stdout.

10|2|Updated Jan 17, 2026
Search Tags:#automation#integration#bash#mcp#claude-code#json-rpc#mainframe
One-click install
npx skills add https://github.com/gtwatts/mainframe --skill mainframe-bash
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mainframe-bash
Source: https://github.com/gtwatts/mainframe/tree/main/skills/claude-code
Command: npx skills add https://github.com/gtwatts/mainframe --skill mainframe-bash

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Exposes Mainframe functions to Claude Code via a JSON-RPC 2.0 server that enables safe, standardized access to runtime tools.

Core Features & Use Cases

  • JSON-RPC 2.0 over stdin/stdout for tool invocation and discovery
  • Tool exposure: initialize, tools/list, tools/call for Claude Code integration
  • Safe, deterministic API surface that isolates Mainframe capabilities behind a controlled protocol
  • Example use case: Claude Code calls initialize and then tools/call to perform safe automation on a host.

Quick Start

Run the mcp-server.sh script and point Claude Code to its JSON-RPC 2.0 endpoint.

Frequently Asked Questions about mainframe-bash

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I expose Mainframe functions to Claude Code for automation?▼

You can expose Mainframe functions to Claude Code by running a JSON-RPC 2.0 server over stdin/stdout. This provides a deterministic protocol supporting initialize, tools/list, and tools/call methods for safe tool invocation.

Can I use bash to create an MCP server for Claude Code integration?▼

Yes, you can create an MCP server for Claude Code using bash. The implementation requires only an executable mcp-server.sh script that communicates as a CLI-style server over stdin/stdout using JSON-RPC 2.0.

What is the JSON-RPC protocol used for Claude Code tool discovery?▼

The JSON-RPC 2.0 protocol enables tool discovery and invocation by supporting initialize, tools/list, and tools/call methods. This deterministic API surface isolates Mainframe capabilities behind a controlled, standardized communication process.

Does the Mainframe bash MCP server require any external dependencies?▼

The Mainframe bash MCP server requires no external dependencies. It operates entirely as a standalone executable mcp-server.sh script, needing only the bash environment to handle JSON-RPC 2.0 communication over stdin/stdout.

How do I safely isolate Mainframe capabilities when integrating with Claude Code?▼

To safely isolate Mainframe capabilities, expose them through a deterministic JSON-RPC 2.0 API surface. This controlled protocol restricts access to specific runtime tools, ensuring safe automation when Claude Code calls the server.

What are the limitations of using bash for a JSON-RPC MCP server?▼

Using bash for a JSON-RPC MCP server limits you to a CLI-style communication model over stdin/stdout. The protocol is deterministic but relies entirely on the mcp-server.sh script for handling all initialization and tool calls without external libraries.

Related Skills

Explore More Software Engineering Skills→
hunterbrewer04hunterbrewer04
1

hook-builder

Generate Bash or Python hook scripts and JSON settings entries for Claude Code lifecycle events.

Community
Intermediate
steipetesteipete
385.7k

mcporter

List and call MCP server tools via HTTP or STDIO.

Community
Intermediate
AradotsoAradotso
7

mcp-server-bash-sdk

Build Bash MCP servers exposing tool_ functions over stdio JSON-RPC.

Official
Intermediate
OliverSiewekeOliverSieweke
13

mcp

Develop and test MCP servers exposing occhio tools to AI agents.

Community
Intermediate