mcpField
J
jumuia-mcp

jumuia-mcp

Local
github.com/gabrielmahiaFinance0Updated 1w ago

About jumuia-mcp

jumuia-mcp is an MCP server for people exploring Kenyan SACCOs, chamas, and cooperatives. It provides practical guides and member-rights information, with responses carrying source details and demo-data caveats.

Key features

  1. 01Find SACCOs by county or sector
  2. 02Guidance for forming a chama
  3. 03Cooperative types and benefits
  4. 04Indicative SACCO loan terms
  5. 05Query cooperative member rights

Use cases

  1. 01Explore SACCO options in a Kenyan county
  2. 02Plan an investment group's formation
  3. 03Check rights on a cooperative topic

MCP support

It exposes five finance and cooperative guidance tools to MCP clients, including SACCO search, chama formation, loan guidance, and rights queries. Responses include a source field.

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-jumuia": {
"command": "uvx",
"args": [
"jumuia-mcp"
]
}
}
}
Run commanduvx jumuia-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
pypijumuia-mcp0.1.11

Tools

5

Saved tool list · updated 6d ago

ParameterTypeRequiredDescription
countyanyNoKenyan county to search for SACCOs in, e.g. 'Nairobi', 'Mombasa'.
sectoranyNoSACCO sector, e.g. 'transport', 'teachers', 'farmers'.

Details

From the project README

jumuia-mcp

Why This Exists

Kenya's SACCOs and chamas move an enormous share of household savings and credit, yet the rules for forming one, the difference between a registered society and a limited company, and what members are actually entitled to are scattered across the Cooperative Societies Act, SASRA circulars and word of mouth. This server puts that guidance where an AI agent can reach it, in one call.

Install

pip install jumuia-mcp

Tools (5)

  • sacco_finder — Find SACCOs (Savings and Credit Cooperatives) in Kenya by sector, county, or type.
    args: county, sector
  • chama_formation_guide — Return step-by-step guide to forming a chama (investment group) in Kenya.
    args: members, purpose
  • cooperative_benefits — Return benefits, structures, and types of cooperatives available in Kenya.
    args: coop_type
  • sacco_loan_guide — Return indicative terms for a Kenyan SACCO loan product.
    args: loan_type, sacco_name
  • cooperative_rights_query — Return the rights a Kenyan cooperative or SACCO member holds on a topic.
    args: topic

Example

from jumuia_mcp.server import chama_formation_guide

result = chama_formation_guide(members=12, purpose='savings')
# steps, legal structures, registration fees, merry-go-round maths

Claude Desktop Integration

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "jumuia-mcp": {
      "command": "python",
      "args": ["-m", "jumuia_mcp.server"]
    }
  }
}

Data & Disclaimers

Guidance is drawn from the Cooperative Societies Act and SASRA regulations. Fees and capital thresholds change — confirm with the Ministry of Cooperatives or sasra.or.ke before relying on a figure.

Every tool response carries a source field. Responses labelled DEMO are illustrative reference data, not a live feed — verify against the authority named in the response before acting on it.

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.