Metadata-Version: 2.4
Name: bima-mcp
Version: 0.1.0
Summary: MCP server for Kenya insurance intelligence — NHIF, parametric crop risk, microinsurance comparison
Author-email: Gabriel Mahia <contact@aikungfu.dev>
License: MIT
Project-URL: Homepage, https://github.com/gabrielmahia/bima-mcp
Project-URL: Repository, https://github.com/gabrielmahia/bima-mcp
Project-URL: Issues, https://github.com/gabrielmahia/bima-mcp/issues
Keywords: mcp,insurance,kenya,africa,nhif,parametric,microinsurance,bima
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastmcp>=2.0.0
Dynamic: license-file

# 🛡️ bima-mcp — Kenya Insurance Intelligence MCP Server

**First insurance intelligence MCP server for East Africa.**

Exposes Kenya insurance data, NHIF coverage analysis, parametric crop risk scoring,
and microinsurance comparison through the Model Context Protocol.

## Why Insurance Infrastructure Matters

In mature economies, insurance is invisible infrastructure — it enables risk-taking by
capping downside. A farmer plants a new crop because crop insurance limits loss.
A parent starts a business because health insurance protects the family.
Without this floor, the rational choice is perpetual caution.

Kenya's insurance penetration: **2.3% of GDP** vs 8–11% in developed markets.
The gap is not cultural — it is the cost of distribution, claims verification,
and actuarial data. All three can be compressed by technology.

## Tools

| Tool | What it does |
|------|-------------|
| `kenya_insurance_products` | List IRA-registered products by type (health, life, crop, device) |
| `nhif_coverage_query` | Query NHIF benefits by hospital tier and procedure type |
| `premium_estimate` | Estimate monthly premiums for any coverage type + income bracket |
| `parametric_crop_risk` | NDMA-based crop insurance risk for smallholder farmers |
| `compare_microinsurance` | Compare affordable products by target group and budget |
| `community_pool_calculator` | Size a chama pooled insurance arrangement |

## Quick Start

```bash
pip install bima-mcp       # coming soon to PyPI
bima-mcp                   # starts the MCP server on stdio
```

## Claude Desktop Integration

```json
{
  "mcpServers": {
    "bima-mcp": {
      "command": "bima-mcp"
    }
  }
}
```

## Use Cases

- **Farmers**: "What crop insurance do I need for my 2-acre maize farm in Nakuru?"
- **Informal workers**: "What NHIF tier 4 inpatient coverage do I get for KES 500/month?"
- **Chama treasurers**: "How do I set up pooled hospitalization cover for 25 members?"
- **Researchers**: "Compare parametric crop insurance risk across Kenya counties"

## Research Basis

- ACRE Africa Parametric Crop Insurance Methodology (2023)
- Kenya IRA Annual Report 2024
- World Bank Insurance Primer for Low-Income Markets (2023)
- NDMA County Drought Monitoring Reports

## ⚠️ Disclaimers

> DEMO data — not real insurance products or binding quotes.
> Not affiliated with NHIF, IRA, or any insurance provider.
> Always consult a licensed IRA-registered insurance agent for actual products.
> Kenya IRA: ira.go.ke

---
*© 2026 Gabriel Mahia / AI Kung Fu LLC · MIT License*
