Metadata-Version: 2.4
Name: kra-mcp
Version: 0.1.1
Summary: MCP server for Kenya Revenue Authority tax compliance — PAYE calculator, PIN reg
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: fastmcp>=0.9

# kra-mcp

> Kenya Revenue Authority tax compliance via MCP — PAYE calculator, VAT guide, PIN registration, tax incentives

[![PyPI](https://img.shields.io/badge/PyPI-v0.1.0-blue)](https://github.com/gabrielmahia/kra-mcp)
[![License](https://img.shields.io/badge/License-MIT-green)](https://github.com/gabrielmahia/kra-mcp)
[![Layer](https://img.shields.io/badge/Layer-Economic-orange)](https://github.com/gabrielmahia/kra-mcp)

## Install

```bash
pip install kra-mcp
```

## What it does

6 MCP tools covering Kenya tax compliance. 1st world equivalent: **TurboTax / HMRC**.

| Tool | Description |
|------|-------------|
| `paye_calculator` | Kenya PAYE tax for 2025 — 7 brackets + personal relief |
| `pin_registration_guide` | Step-by-step KRA PIN registration (individual and company) |
| `vat_guide` | VAT registration threshold, rates, filing deadlines |
| `tax_filing_calendar` | All Kenya tax deadlines in one place |
| `withholding_tax_rates` | Rates by payment type: dividends, royalties, professional fees |
| `tax_incentives_guide` | EPZ, SEZ, tech, pension, startup tax incentives |

## Usage

```bash
# Run as standalone MCP server
kra-mcp

# Or add to Claude Desktop / any MCP client
# Add to your MCP config: {"command": "kra-mcp"}
```

## Part of the Kenya Coordination Infrastructure Stack

This is one of 23 MCP servers covering the full coordination infrastructure of East Africa:

**Economic:** mpesa · mkopo · bima · soko · sifa · remit · kra · faida  
**Physical:** wapimaji · nishati · usafiri · ardhi  
**Social:** afya · afya-ya-akili · elimu · kazi · haki-ya-kazi · kilimo · jumuia  
**Civic:** nyumba · habari · mazingira · civic-agent-kit  

→ [The Nairobi Stack](https://gabrielmahia.github.io/nairobi-stack)  
→ [Full Portfolio](https://gabrielmahia.github.io)

## Trust Integrity

All data in this server is **clearly labeled DEMO** where synthetic. Verify all operational data with the relevant Kenyan government authority before use.

## License

MIT © Gabriel Mahia | [AI-KungFU](https://github.com/gabrielmahia) | contact@aikungfu.dev

> *Decision infrastructure for East Africa*
