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.
README
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-mcp
Configuration
Configure the connection using environment variables:
| Variable | Description | Required | Default |
|---|---|---|---|
IBMI_HOST |
IBM i hostname or IP | Yes | — |
IBMI_PORT |
TN5250 port | No | 23 |
IBMI_SSL |
Enable TLS | No | false |
IBMI_USER |
Username for auto-signon | No | — |
IBMI_PASSWORD |
Password for auto-signon | No | — |
IBMI_DEVICE_NAME |
Virtual device name | No | — |
IBMI_CODEPAGE |
EBCDIC codepage | No | cp037 |
IBMI_TERMINAL_TYPE |
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 |
Connect to an IBM i system via TN5250 |
disconnect |
Disconnect the active session |
read_screen |
Read the current screen content and input fields |
send_keys |
Type text into the current input field |
send_key |
Send a function/attention key (Enter, F1-F24, PageUp, PageDown, Tab, etc.) |
set_cursor |
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.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.