To let an assistant use these tools, grant Insurance operations on the consent screen, or just
Reinsurance under its Fine-tune. The scope is reinsurance.
Read tools work with Read only or Read & write access; write tools only with
Read & write.
Your assistant doesn't see these tools straight away. It finds them with search_tools or
describe_tools, and runs one with use_tool, passing its name and
arguments. Most assistants do this for you: just ask for what you want.
What your assistant is told about this group
Reinsurance, from whichever side your organisation is on. Treaties (terms, how much risk is kept, capacity): the insurer can edit them, the reinsurer can read them. Cessions: each life passed to a reinsurer, and how far it has got (sent, then acknowledged). Rule packs: the signed underwriting and pricing rules your organisation wrote or adopted. get_rule_pack lists a pack's rate tables and the covers and products using it; get_rate_table reads a table's rows (filtered, a page at a time).
The descriptions below are the ones your assistant reads, so they're written for it. When a connection covers more than one
organisation, the assistant passes org (the organisation's slug, from list_orgs) to say which one.
list_treaties
Read List reinsurance treaties
Treaties where the org is either side. role filters to the org's side: manufacturer (cedent) or reinsurer.
Arguments
| Field | Type | Description |
|---|---|---|
| role | string |
One of: "manufacturer", "reinsurer"
|
| treaty_type | string |
One of: "yrt", "surplus", "quota_share", "coinsurance"
|
| limit | integer | Max rows (1-100, default 25) |
| org | string | Organisation slug: required when this authorization covers more than one organisation (see list_orgs) |
get_treaty
Read Get a treaty
Full treaty terms: retention, capacity, eligibility predicates and the ceded premium table, plus how many cessions sit under it.
Arguments
| Field | Type | Description |
|---|---|---|
| id required | string | Treaty id |
| org | string | Organisation slug: required when this authorization covers more than one organisation (see list_orgs) |
create_treaty
Write Create a treaty
Author a reinsurance treaty with this org as the manufacturer (cedent).
Arguments
| Field | Type | Description |
|---|---|---|
| reference required | string | |
| treaty_type required | string |
One of: "yrt", "surplus", "quota_share", "coinsurance"
|
| reinsurer_org_id required | string | Org id of the reinsurer |
| currency_code | string | e.g. GBP |
| retention_amount | integer | Manufacturer retention per life, in pence |
| auto_capacity_amount | integer | Automatic acceptance capacity, in pence |
| effective_from | string | YYYY-MM-DD |
| effective_to | string | YYYY-MM-DD (open-ended if omitted) |
| eligibility_predicates | object | Eligibility rules JSON (product_types, geographies, age_range) |
| ceded_premium_table | object | Ceded premium rate table JSON |
| org | string | Organisation slug: required when this authorization covers more than one organisation (see list_orgs) |
update_treaty
Write Update a treaty
Edit treaty terms. Manufacturer-only: the reinsurer side is read-only. Only the fields you pass change.
Arguments
| Field | Type | Description |
|---|---|---|
| id required | string | Treaty id |
| reference | string | |
| treaty_type | string |
One of: "yrt", "surplus", "quota_share", "coinsurance"
|
| reinsurer_org_id | string | Org id of the reinsurer |
| currency_code | string | e.g. GBP |
| retention_amount | integer | Manufacturer retention per life, in pence |
| auto_capacity_amount | integer | Automatic acceptance capacity, in pence |
| effective_from | string | YYYY-MM-DD |
| effective_to | string | YYYY-MM-DD (open-ended if omitted) |
| eligibility_predicates | object | Eligibility rules JSON (product_types, geographies, age_range) |
| ceded_premium_table | object | Ceded premium rate table JSON |
| org | string | Organisation slug: required when this authorization covers more than one organisation (see list_orgs) |
list_cessions
Read List cessions
Per-life risk cessions under the org's treaties (either side). state: live, unemitted (not yet sent to the reinsurer), unacked (sent, awaiting ack), superseded.
Arguments
| Field | Type | Description |
|---|---|---|
| role | string |
One of: "manufacturer", "reinsurer"
|
| treaty_id | string | Only cessions under this treaty |
| state | string |
One of: "live", "unemitted", "unacked", "superseded"
|
| limit | integer | Max rows (1-100, default 25) |
| org | string | Organisation slug: required when this authorization covers more than one organisation (see list_orgs) |
get_cession
Read Get a cession
One cession in full with its event timeline (emitted, acked, superseded).
Arguments
| Field | Type | Description |
|---|---|---|
| id required | string | Cession id |
| org | string | Organisation slug: required when this authorization covers more than one organisation (see list_orgs) |
list_rule_packs
Read List rule packs
Underwriting rule packs the org has authored (as reinsurer) or adopted (as manufacturer): decision tables + rate tables, signed and versioned.
Arguments
| Field | Type | Description |
|---|---|---|
| status | string |
One of: "draft", "signed_reinsurer", "signed_both", "live", "superseded", "rolled_back"
|
| product_id | string | Only packs for this product |
| limit | integer | Max rows (1-100, default 25) |
| org | string | Organisation slug: required when this authorization covers more than one organisation (see list_orgs) |
get_rule_pack
Read Get a rule pack
Full rule pack payload (decision tables, rates) plus whether the org is its author or adopter, its rate tables (read rows with get_rate_table) and the covers and products that use it as their live rule pack.
Arguments
| Field | Type | Description |
|---|---|---|
| id required | string | Rule pack id |
| org | string | Organisation slug: required when this authorization covers more than one organisation (see list_orgs) |
get_rate_table
Read Get a rate table
One rule-pack rate table (ids from get_rule_pack) with its rows: each row's inputs (keyed by the table's input_columns) and rate_per_mille. Filter by exact input values (case-insensitive), sort by row_index, rate_per_mille or an input key, and page with offset/limit (limit max 500). total_rows counts every matching row.
Arguments
| Field | Type | Description |
|---|---|---|
| id required | string | Rate table id |
| filters | object | Input key => value, e.g. {"age": "40", "smoker": "true"} |
| sort | string | row_index (default), rate_per_mille, or an input key |
| dir | string |
One of: "asc", "desc"
|
| offset | integer | |
| limit | integer | |
| org | string | Organisation slug: required when this authorization covers more than one organisation (see list_orgs) |