Skip to main content
Cursor is an AI-first code editor with native MCP support. It provides seamless integration with MCP servers for enhanced AI capabilities.
Platform Support: macOS, Linux, Windows Transport Modes: Stdio (local) and HTTP (remote) Configuration: .cursor/mcp.json or Cursor settings

​
Local (Stdio) Setup

Configuration file: Add to Cursor settings or .cursor/mcp.json in your project: 
{
  "mcpServers": {
    "ibmi-mcp": {
      "command": "npx",
      "args": ["@ibm/ibmi-mcp-server@latest", "-y", "--tools", "/absolute/path/to/tools"],
      "env": {
        "DB2i_HOST": "your-ibmi-host.com",
        "DB2i_USER": "your-username",
        "DB2i_PASS": "your-password",
        "DB2i_PORT": "8076",
        "MCP_TRANSPORT_TYPE": "stdio"
      }
    }
  }
}
The --tools path must be an absolute path.

​
Remote (HTTP) Setup

{
  "mcpServers": {
    "ibmi-mcp": {
      "url": "http://localhost:3010/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN_HERE"
      }
    }
  }
}

​
Testing the Connection

  1. Restart Cursor after configuration
  2. Open the AI chat panel
  3. Ask “What tools are available?”
  4. Test with “Show me the IBM i system status”

​
Troubleshooting

  • Verify JSON syntax in configuration file
  • Restart Cursor completely
  • Check that npx -y @ibm/ibmi-mcp-server@latest works from terminal
  • Ensure all paths are absolute
  • Verify server is running with authentication enabled
  • Check token hasn’t expired
  • Get fresh token: node get-access-token.js --verbose

​
Next Steps

SQL Tools

Create custom SQL tools

Configuration

Explore all configuration options

Quick Start

Basic server setup guide

Other Clients

Explore other MCP clients

​
Additional Resources