InsurGateway Error Management MCP Server

A Model Context Protocol (MCP) server for tracking, analyzing, and reporting errors from InsurGateway.

Features

• Error Tracking — List, filter, and search errors by date, branch, product, company, and status
• Error Logs — View detailed request/response logs for each error
• Error Analysis — Get analysis details with possible causes and suggestions
• Error Actions — Pin errors, send error reports, and file bug reports
• Lookups — Search products and list insurance companies for filtering

Setup

Choose your tool below. Replace credentials with your own.

Environments

| Environment | IGW_BASE_URL | |-------------|----------------| | Test | https://testgatewayapi.insurapps.net/api | | Production | https://gatewayapi.insurapps.net/api |

Claude Code

claude mcp add-json --scope user igw-error-management '{
  "command": "npx",
  "args": ["-y", "igw-error-management-mcp@latest"],
  "env": {
    "IGW_BASE_URL": "https://testgatewayapi.insurapps.net/api",
    "IGW_USERNAME": "your-username",
    "IGW_PASSWORD": "your-password",
    "IGW_WEB_API_KEY": "your-api-key"
  }
}'

Claude Desktop

Edit config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "igw-error-management": {
      "command": "npx",
      "args": ["-y", "igw-error-management-mcp@latest"],
      "env": {
        "IGW_BASE_URL": "https://testgatewayapi.insurapps.net/api",
        "IGW_USERNAME": "your-username",
        "IGW_PASSWORD": "your-password",
        "IGW_WEB_API_KEY": "your-api-key"
      }
    }
  }
}

Restart Claude Desktop after saving.

Cursor

Add to .cursor/mcp.json in your project root (or ~/.cursor/mcp.json for global):

{
  "mcpServers": {
    "igw-error-management": {
      "command": "npx",
      "args": ["-y", "igw-error-management-mcp@latest"],
      "env": {
        "IGW_BASE_URL": "https://testgatewayapi.insurapps.net/api",
        "IGW_USERNAME": "your-username",
        "IGW_PASSWORD": "your-password",
        "IGW_WEB_API_KEY": "your-api-key"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "igw-error-management": {
      "command": "npx",
      "args": ["-y", "igw-error-management-mcp@latest"],
      "env": {
        "IGW_BASE_URL": "https://testgatewayapi.insurapps.net/api",
        "IGW_USERNAME": "your-username",
        "IGW_PASSWORD": "your-password",
        "IGW_WEB_API_KEY": "your-api-key"
      }
    }
  }
}

OpenAI Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.igw-error-management]
command = "npx"
args = ["-y", "igw-error-management-mcp@latest"]

[mcp_servers.igw-error-management.env]
IGW_BASE_URL = "https://testgatewayapi.insurapps.net/api"
IGW_USERNAME = "your-username"
IGW_PASSWORD = "your-password"
IGW_WEB_API_KEY = "your-api-key"

Antigravity (Firebase Studio)

Add to .idx/mcp.json in your workspace:

{
  "mcpServers": {
    "igw-error-management": {
      "command": "npx",
      "args": ["-y", "igw-error-management-mcp@latest"],
      "env": {
        "IGW_BASE_URL": "https://testgatewayapi.insurapps.net/api",
        "IGW_USERNAME": "your-username",
        "IGW_PASSWORD": "your-password",
        "IGW_WEB_API_KEY": "your-api-key"
      }
    }
  }
}

Example Queries

Once set up, try asking your AI assistant:

• "Son 24 saatte hangi hatalar var?"
• "Quick Sigorta'daki çözülmemiş hataları göster"
• "Trafik branşında en çok hata veren sigorta şirketleri hangileri?"
• "Bu hatanın request/response detayına bak"
• "Son 1 haftada ConnectionError olan hataları listele"
• "Allianz Sigorta'nın ürünlerinde timeout hatalarını getir"
• "Bu hatayı analiz et, ne olmuş?"
• "Bu hatayı IGW ekibine bug olarak raporla"
• "Hangi sigorta şirketleri aktif?"
• "Kasko ürünlerini ara"

Tools

Error Queries (read-only)

| Tool | Description | |------|-------------| | igw_errors_list | List errors with filters (date range, branch, product, company, status flags) | | igw_errors_operations | Get error operations — which service operations produce errors | | igw_errors_logs | Get detailed error log entries | | igw_errors_log_detail | Get full request/response data for a specific error log | | igw_errors_analyze | Analyze a specific error — possible causes and suggestions |

Error Actions (write)

| Tool | Description | |------|-------------| | igw_errors_pin | Pin/unpin an error for tracking | | igw_errors_send_report | Send an error report with description to the relevant team | | igw_errors_send_bug_report | Send a bug report by reference number to InsurGateway |

Lookups (read-only)

| Tool | Description | |------|-------------| | igw_products_search | Search products by name — get product IDs for error filters | | igw_insurance_companies | List available insurance companies — get company IDs for error filters |

License

MIT