ContractExperimentalv0.1.0-alpha

BiPRO Change of Address Notification

MCP server for transmitting and receiving customer address changes between brokers and insurers using BiPRO 430.x (inbound notification) and BiPRO 502.x (outbound contract amendment).

Standards:BiPRO 430.xBiPRO 502.xBiPRO 430.xBiPRO 502.x

Installation

$ npx @aaif/mcp-bipro-address-change@alpha

Try in Claude Desktop

claude_desktop_config.json
{
  "mcpServers": {
    "bipro-change-of-address": {
      "command": "npx",
      "args": [
        "@aaif/mcp-bipro-address-change@alpha"
      ],
      "env": {}
    }
  }
}
Paste into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Exposed MCP Tools

ToolDescription
subscribe_address_changesSubscribe to inbound BiPRO 430.x address-change deliveries
get_pending_address_changesList unprocessed address-change events
submit_address_changeForward a validated address change as a BiPRO 502.x amendment
validate_addressValidate a postal address against geocoding rules before submission

Overview

The BiPRO Change of Address Notification MCP server enables AI agents to process customer change-of-address business events in line with German BiPRO standards.

Inbound flow (insurer → broker)

Subscribes to BiPRO 430.x deliveries and filters for change-of-address GeVo categories. Surfaces structured address-change events with policy and customer context, ready for downstream processing.

Outbound flow (broker → insurer)

Accepts a structured address change request, validates against postal and geocoding rules, and forwards as a BiPRO 502.x contract amendment to the responsible insurer's endpoint.

Supported scenarios

Designed for property/casualty and life lines, supports multi-contract addresses, dual residency, and partial updates (postal address only vs. full residence change).

Prerequisites

  • BiPRO 430.x and 502.x-compliant backend endpoints
  • Valid BiPRO credentials (username / password or OAuth2 client credentials)
  • Node.js ≥ 18 or Docker

Configuration

BIPRO_430_ENDPOINT=https://your-insurer.example/bipro/v430

BIPRO_502_ENDPOINT=https://your-insurer.example/bipro/v502

BIPRO_USERNAME=your-username

BIPRO_PASSWORD=your-password

Exposed MCP Tools

ToolDescription
subscribe_address_changesSubscribe to inbound BiPRO 430.x address-change deliveries
get_pending_address_changesList unprocessed address-change events
submit_address_changeForward a validated address change as a BiPRO 502.x amendment
validate_addressValidate a postal address against geocoding rules before submission

Same category or shared standard