Skip to main content
Watch: I Built an AI App Without Leaving Databricks

Databases - official IBM server

IBM i MCP server

MCP server for IBM i systems that exposes YAML-defined SQL tools over Db2 for i (via Mapepire) for tasks such as performance monitoring, security auditing and database administration. It runs locally from @ibm/ibmi-mcp-server (npm); the notes below cover how it authenticates.

Last verified 3 sources

Install

Claude Code

About Claude Code
Terminal
claude mcp add ibmi-mcp \
  --env DB2i_HOST=your-ibmi-host.com \
  --env DB2i_USER=your-username \
  --env DB2i_PASS=your-password \
  --env DB2i_PORT=8076 \
  --env MCP_TRANSPORT_TYPE=stdio \
  -- npx -y @ibm/ibmi-mcp-server@latest --transport stdio --tools /absolute/path/to/tools

Cursor

About Cursor
JSON
{
  "mcpServers": {
    "ibmi-mcp": {
      "command": "npx",
      "args": ["@ibm/ibmi-mcp-server@latest", "-y", "--transport", "stdio", "--tools", "/absolute/path/to/tools"],
      "env": {
        "DB2i_HOST": "your-ibmi-host.com",
        "DB2i_USER": "your-username",
        "DB2i_PASS": "your-password",
        "DB2i_PORT": "8076"
      }
    }
  }
}

VS Code

JSON
{
  "servers": {
    "ibmiMcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["@ibm/ibmi-mcp-server@latest", "-y", "--transport", "stdio", "--tools", "/absolute/path/to/tools"],
      "env": {
        "DB2i_HOST": "your-ibmi-host.com",
        "DB2i_USER": "your-username",
        "DB2i_PASS": "your-password",
        "DB2i_PORT": "8076"
      }
    }
  }
}

Notes and caveats

  • Requires Mapepire running on IBM i (port 8076) and Node.js 18+.
  • Tools are defined in YAML tool files (prebuilt toolsets such as performance are provided).
  • Authenticates to IBM i with DB2i user credentials; HTTP mode can require a bearer token.

More MCP servers for databases

Related reading

FAQ

What does the IBM i MCP server do?

MCP server for IBM i systems that exposes YAML-defined SQL tools over Db2 for i (via Mapepire) for tasks such as performance monitoring, security auditing and database administration.

How do I add the IBM i MCP server to Claude Code?

IBM documents a Claude Code config; copy it from the Claude Code section of this page. Snippets for Cursor and VS Code are there too.

Does the IBM i MCP server need authentication?

It uses a scheme other than OAuth or an API key, such as the session of the app or instance it runs in; the notes on this page describe it. Transport: stdio, Streamable HTTP. Status: Unlabelled, last checked October 17, 2026.

Sources

Last verified against 3 IBM pages, then re-checked independently.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.