Back to Directory/Developer Tools

io.github.gabrielmahia/kilimo-mcp

MCP server for agriculture coordination in East Africa (kilimo = farming)

Developer ToolsPythonv0.1.3

kilimo-mcp

kilimo-mcp Glama score smithery badge


Compatible with claude-sonnet-5 (released 2026-06-30) — Anthropic's most agentic Sonnet yet. Runs multi-step tool chains end-to-end without stopping short. Install: pip install kilimo-mcp · Use with any MCP client.


Kenya precision agriculture via MCP — crop calendar, fertilizer, pest alerts, KALRO varieties

PyPI License Layer

AI Architecture: Agricultural Domain RAG

Agricultural AI for East Africa requires domain-specific retrieval — generic models hallucinate crop varieties, soil types, and local market conditions.

Research basis:

  • AgriIR (Springer 2026): configurable RAG framework for agricultural knowledge retrieval — validates domain-specific retrieval over monolithic agricultural models. Key finding: low computational cost with high accuracy when knowledge base is curated.
  • RAG vs Fine-tuning on Agriculture (arXiv 2401.08406): RAG outperforms fine-tuning for dynamic agricultural knowledge (seasonal, location-specific, real-time market).
  • DPGA 2026 focus: Domain-specific DPGs in agriculture and climate are a 2026 strategic priority for Co-Develop and DPGA members.

Knowledge base pairing:

  • Kenya National Drought Management Authority (NDMA) data → drought → crop risk
  • Kenya Meteorological Department seasonal forecasts → planting calendar
  • East Africa agricultural historical data (1906-1925, HuggingFace: gmahia)

Coordination: Pairs with wapimaji-mcp (water), bima-mcp (insurance), soko-mcp (markets) via africa-coord-bus for full drought response cascade.

Install

pip install kilimo-mcp

What it does

6 MCP tools covering Kenya precision agriculture. 1st world equivalent: Climate Corp / Granular.

ToolDescription
crop_calendarKenya crop planting and harvesting calendar by region
fertilizer_guideFertilizer recommendations by crop and soil type
pest_disease_alertCrop pest and disease identification and management
market_timing_guideBest timing to sell produce based on price cycles
kalro_varietiesKALRO improved crop variety recommendations
input_cost_calculatorKenya farm input cost calculator and comparison

Usage

# Run as standalone MCP server
kilimo-mcp

# Or add to Claude Desktop / any MCP client
# Add to your MCP config: {"command": "kilimo-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
→ 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 | contact@aikungfu.dev

Decision infrastructure for East Africa

Part of the East Africa Coordination Stack

This MCP server is one of 32 tools in the Kenya coordination infrastructure. It connects to africa-coord-bus — the coordination event bus that routes signals between domains automatically.

When this server detects a threshold condition, the bus notifies:

  • bima-mcp — parametric insurance evaluation
  • kilimo-mcp — agricultural advisory
  • afya-mcp — health surveillance activation
  • county-mcp — county office alert
pip install africa-coord-bus

All servers: pypi.org/user/gmahia

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.

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
uvx kilimo-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-gabrielmahia-kilimo-mcp": {
      "command": "uvx",
      "args": [
        "kilimo-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

kilimo-mcppypi

Compatible MCP Clients

io.github.gabrielmahia/kilimo-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More