mcpField
K
kra-mcp

kra-mcp

Local
github.com/gabrielmahiaFinance0Updated 2d ago
Repository

About kra-mcp

kra-mcp is an MCP server for Kenya tax compliance, for individuals and organizations seeking tax calculations and filing guidance. Its six tools cover PAYE estimates, PIN registration, VAT, filing deadlines, withholding rates, and tax incentives; calculations are estimates.

Key features

  1. 01PAYE and take-home pay estimator
  2. 02Individual and company PIN guide
  3. 03VAT thresholds, rates, and deadlines
  4. 04Tax filing calendar
  5. 05Withholding tax rates by payment type
  6. 06Tax incentives guide

Use cases

  1. 01Estimate PAYE and take-home pay
  2. 02Find steps for KRA PIN registration
  3. 03Check VAT filing deadlines
  4. 04Review withholding rates or tax incentives

MCP support

Exposes six Kenya tax compliance tools to MCP clients, covering PAYE, PIN registration, VAT, filing dates, withholding rates, and incentives. It can run standalone or be added to an MCP client; estimates should be treated as estimates.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "gabrielmahia-kra": {
      "command": "uvx",
      "args": [
        "kra-mcp"
      ]
    }
  }
}
Run commanduvx kra-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypikra-mcp0.1.12

Tools

6

Saved tool list · updated 6d ago

ParameterTypeRequiredDescription
include_nhifanyNo
include_nssfanyNo
include_shifanyNo
include_housing_levyanyNo
annual_gross_income_kesnumberYes

Details

From the project README

kra-mcp

kra-mcp Glama score smithery badge

Install: pip install kra-mcp · Use with any MCP client.

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

PyPI License Layer

Install

pip install kra-mcp

What it does

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

ToolDescription
paye_calculatorKenya PAYE and take-home pay (2026 figures): NSSF capped at KES 6,480/month, SHIF 2.75%, housing levy 1.5%, 5 bands, KES 2,400 monthly relief. Estimate; see assumptions
pin_registration_guideStep-by-step KRA PIN registration (individual and company)
vat_guideVAT registration threshold, rates, filing deadlines
tax_filing_calendarAll Kenya tax deadlines in one place
withholding_tax_ratesRates by payment type: dividends, royalties, professional fees
tax_incentives_guideEPZ, SEZ, tech, pension, startup tax incentives

Usage

# 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 the MCP servers covering the 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
→ Full Portfolio

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 | [email protected]

Decision infrastructure for East Africa

Part of the East Africa Coordination Stack

This MCP server is part of the Kenya coordination infrastructure. Connect it to africa-coord-bus — the coordination event bus that routes signals between domains automatically.

pip install africa-coord-bus

All servers: pypi.org/user/gmahia Live demo: coord-cascade-demo

IP & Collaboration

MIT licensed. Feedback via GitHub Issues only — pull requests are not accepted. Demo data is labeled DEMO and is not suitable for operational decisions. Full policy: docs/architecture/IP_POLICY.md. Security reports: see SECURITY.md.

Part of the East Africa coordination stack

Model-agnostic by design: closed APIs, open-weight models, and small distilled models are all first-class citizens.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.