Cursor

Configure IBM i MCP Server with Cursor AI-first code editor

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

Server Not Appearing

• 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

Authentication Failed

• 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

• Cursor MCP Documentation
• IBM i MCP Quick Start
• Configuration Reference