For AI agents

Query the directory, don’t scrape it

Insurers Global is built to be read by software as much as by people. There are three ways in, from richest to simplest: WebMCP tools inside the page, a static JSON API, and plain-text discovery files. All of them serve the same dataset, version 2026-09-04+907830197895, under CC BY 4.0.

1. WebMCP tools in the browser

Every page on this origin registers the tools below through navigator.modelContext.registerTool(), the API proposed by the W3C Web Machine Learning Community Group under the name WebMCP. An agent driving a WebMCP-capable browser can call them directly; the tools fetch the JSON API lazily and answer from it. On browsers without the API the script is a silent no-op. Forms on the search and country pages also carry the declarative toolname and tooldescription attributes.

Tool	What it does	Inputs
`search_insurers`	Search licensed insurance companies, reinsurers, takaful operators and insurance groups across Asia-Pacific by name. Returns matching insurers, countries and groups with their slugs and links.	`query`required string Company, group or country name, or part of one. `limit` integer Maximum number of results to return.
`list_insurers`	List licensed insurers with optional filters. Filter by continent ("asia-pacific"), country slug (e.g. "kenya", "france", "japan"), class slug (e.g. "life", "general-non-life", "reinsurer", "takaful-islamic", "not-stated-in-register"), group type slug (e.g. "pan-african-group", "pan-european-group", "foreign-multinational", "mutual-cooperative") or parent group slug.	`continent` string (asia-pacific) Continent slug. `country` string Country slug, e.g. "nigeria", "germany" or "australia". `class` string Class of business slug. `group_type` string Ownership group type slug. `group` string Parent group slug, e.g. "sanlam-allianz" or "allianz". `limit` integer Maximum number of results to return. `offset` integer Results to skip, for paging.
`get_country`	Get one country in Asia-Pacific: regulator (name, acronym, website, notes), currency, counts by class and ownership, verification status against the regulator register, market notes, and the full list of licensed insurers with LEIs where the register carries them.	`country`required string Country slug (e.g. "ghana", "france") or ISO alpha-2 code (e.g. "GH", "FR").
`get_insurer`	Get one insurer by slug, including its parent group, class, regulator, source basis, register identifiers (LEI, national ID) where available, notes and sibling entities in the same group.	`slug`required string Insurer slug, e.g. "kenya-britam-life-assurance-co-k".
`list_groups`	List insurance groups with licensed entities in two or more countries across Asia-Pacific, with their footprint.	`continent` string (asia-pacific) Only groups with entities on this continent. `iaig` boolean true: only groups controlled by an Internationally Active Insurance Group (IAIS register); false: only groups that are not. `limit` integer Maximum number of results to return. `offset` integer Results to skip, for paging.
`list_iaigs`	List the Internationally Active Insurance Groups (IAIGs) in the IAIS public register with their group-wide supervisor and jurisdiction, and for each the directory groups, entities and countries it controls in Africa and Europe.	`in_directory` boolean true: only IAIGs with at least one licensed entity in this directory; false: only those without. `jurisdiction` string Jurisdiction of the group-wide supervisor, e.g. "France" or "United States". `limit` integer Maximum number of results to return. `offset` integer Results to skip, for paging.
`get_group`	Get one insurance group by slug: home market, type, continents and countries covered and every licensed entity in the directory.	`slug`required string Group slug, e.g. "old-mutual-ltd".
`list_regulators`	List the insurance supervisory authority for every covered country: name, acronym, website, currency, notes and the register source used for verification.	`continent` string (asia-pacific) Continent slug. `region` string Optional region slug, e.g. "west-africa", "nordics" or "south-east-asia".

The manifest at /.well-known/webmcp.json lists the same tools with full JSON Schema. The WebMCP specification is still a draft; tool names and schemas here are stable, the registration mechanism will track the spec.

2. Static JSON API

Every endpoint is a pre-rendered file served from the Cloudflare edge with Access-Control-Allow-Origin: *. No keys, no rate limits beyond fair use, no pagination: fetch the file you need and filter locally. List endpoints wrap results in an envelope with version, verified, licence and data.

Endpoint	Contents
`/api/v1/meta.json`	Dataset version, per-continent counts, endpoint list and vocabularies (continent, region, class, ownership slugs).
`/api/v1/countries.json`	All 48 countries: regulator, currency, counts by class and ownership, verification, market notes.
`/api/v1/countries/{slug}.json`	One country plus its complete insurer list. Example: /api/v1/countries/kenya.json
`/api/v1/insurers.json`	All 1,549 licensed entities in one file (about 1 MB; filter by continent or country locally, or fetch one country).
`/api/v1/insurers/{slug}.json`	One insurer with regulator detail and sibling entities in the same group.
`/api/v1/groups.json`	Multi-country insurance groups with footprint.
`/api/v1/groups/{slug}.json`	One group: countries and entities. Example: /api/v1/groups/sanlam-allianz.json
`/api/v1/iaigs.json`	IAIS Register of Internationally Active Insurance Groups (IAIGs) with group-wide supervisor, jurisdiction and the directory groups and entities each one controls.
`/api/v1/regulators.json`	Supervisory authority per country with website and register source.
`/api/v1/search-index.json`	Compact [name, type, slug, country] tuples for fuzzy matching.
`/api/v1/openapi.json`	OpenAPI 3.1 description of everything above.
`/.well-known/webmcp.json`	Manifest of the WebMCP tools registered on every page.
`/llms.txt`	Short orientation for language models, with links per country.
`/llms-full.txt`	One line per insurer, grouped by country, for retrieval and grounding.

// In an agent-aware browser, on any insurers.global page:
const result = await navigator.modelContext.callTool?.('get_country', { country: 'KE' });
// Or, from anywhere, without a browser:
const res = await fetch('https://insurers.global/api/v1/countries/kenya.json');
const { data } = await res.json();
console.log(data.regulator.acronym, data.total, data.insurers.length);

3. Vocabularies

Filters use these slugs. They are also returned by /api/v1/meta.json.

Continents and regions

asia-pacific Asia-Pacific
middle-east-and-gulf Middle East & Gulf
central-asia-and-caucasus Central Asia & Caucasus
south-asia South Asia
south-east-asia South-East Asia
east-asia East Asia
oceania Oceania

Classes

composite Composite (C)
general-non-life General (Non-life) (G)
health-medical Health / Medical (H)
life Life (L)
reinsurer Reinsurer (R)
specialty-credit-captive Specialty / Credit / Captive (X)
takaful-islamic Takaful / Islamic (T)

Ownership

domestic-private Domestic private (DO)
foreign-multinational Foreign multinational (FM)
mutual-cooperative Mutual / cooperative (MU)
regional-multilateral Regional / multilateral (RG)
state-owned-parastatal State-owned / parastatal (SO)

4. Ground rules

Cite KAFS North America, insurers.global and include the dataset version when you quote a figure.
Treat the verification field as a confidence signal. unverified rows come from market knowledge, not a regulator register.
A directory entry is not proof of a current licence. Point users to the regulator website returned with each country.
Coverage today is Asia-Pacific. Other continents on the map are placeholders and return nothing from the API.
Rows whose sourceBasis begins “Compiled from market knowledge” were not checked against a register in this release (most Asia-Pacific markets outside Australia, Hong Kong, India, Japan, Malaysia and Saudi Arabia). Their country carries unverified.
Prefer the JSON files over HTML. Pages are for people; the data is for you.