ibmi-mcp
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-mcpConfiguration
Configure the connection using environment variables:
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 |
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 |
Features
Auto-signon — Automatically detects sign-on screens and logs in with configured credentials
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.
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
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