ibmi-mcp
This server gives AI agents terminal access to IBM i (AS/400) systems via TN5250 green-screen emulation, enabling full interactive control of the system.
Connect/Disconnect — Establish or terminate a TN5250 session to an IBM i system, with optional TLS encryption and SSH tunneling support when direct port access is unavailable
Read Screen — Capture the current 5250 screen content, including visible text, cursor position, input field metadata, and screen dimensions
Type Text — Send keystrokes/text input into the current input field at the cursor position
Send Function Keys — Trigger attention and function keys such as Enter, F1–F24, PageUp, PageDown, Tab, Backtab, Clear, Help, Print, and Attn
Position Cursor — Move the cursor to any specific row and column on the screen
Upload Files — Transfer files from the local machine to the IBM i Integrated File System (IFS) via SFTP
Download Files — Retrieve files from the IBM i IFS to the local system via SFTP
Auto-Signon — Automatically detect login screens and authenticate using configured credentials
Codepage Support — Handle EBCDIC codepage translation for proper character encoding
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ibmi-mcpConnect to my IBM i system and read the current screen."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ibmi-mcp
Give your AI Agent terminal access to your IBM i system via TN5250.
ibmi-mcp is an MCP server that lets AI Agents like Claude interact with IBM i the same way a human would through a 5250 green-screen terminal.
Installation
Install and register with Claude Code:
claude mcp add ibmi-5250 -- uvx ibmi-mcpThis requires the connection environment variables to be set in your shell profile. You can also pass them inline with -e flags:
claude mcp add ibmi-5250 \
-e IBMI_HOST=myhost.example.com \
-e IBMI_USER=myuser \
-e IBMI_PASSWORD=mypassword \
-- uvx ibmi-mcpRelated MCP server: can-see
Configuration
Variable | Description | Required | Default |
| IBM i hostname or IP | Yes | — |
| TN5250 port | No | 23 |
| Enable TLS | No | false |
| Username for auto-signon | No | — |
| Password for auto-signon | No | — |
| Virtual device name | No | — |
| EBCDIC codepage | No | cp037 |
| Terminal type | No | IBM-3179-2 |
| Tunnel TN5250 through SSH | No | false |
| SSH port for file transfer and tunneling | No | 22 |
| Path to SSH private key | No | — |
| Path to known_hosts file | No | — |
When IBMI_USER and IBMI_PASSWORD are set, ibmi-mcp will automatically sign on when it detects a login screen after connecting.
Tools
Tool | Description |
| Connect to an IBM i system via TN5250 |
| Disconnect the active session |
| Read the current screen content and input fields |
| Type text into the current input field |
| Send a function/attention key (Enter, F1-F24, PageUp, PageDown, Tab, etc.) |
| Position the cursor at a specific row and column |
| Upload a file from the local system to the IBM i |
| Download a file from the IBM i to the local system |
Features
Auto-signon — Automatically detects sign-on screens and logs in with configured credentials
File transfer — Upload and download files to/from the IBM i IFS via SFTP
SSH tunneling — Tunnel TN5250 through SSH when port 23 is not directly reachable
Full key support — Enter, F1-F24, PageUp, PageDown, Tab, Backtab, Clear, Help, Print, Attn
Local editing — Backspace, Delete, Field Exit, Home, and End handled locally for responsive editing
Structured screen data — Returns screen text, cursor position, and input field metadata
Configurable codepage — Supports EBCDIC codepage translation (default: CP037)
License
BSD 2-Clause. See LICENSE for details.
About Whitehorn Ltd. Co.
ibmi-mcp is developed and maintained by Whitehorn Ltd. Co., a legacy system modernization firm. We specialize in IBM i, RPG, COBOL, and midrange platforms. We help our clients protect what they can't afford to break while building a path forward.
Learn more about how Whitehorn Ltd. Co. can help you modernize your IBM midrange systems at whitehorn.ltd.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/WhitehornLtd/ibmi-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server