Skip to main content

📊 soko-mcp — Kenya Commodity Price Intelligence MCP Server

soko-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 soko-mcp · Use with any MCP client.


A farmer deciding whether to sell or hold needs current prices across multiple markets simultaneously. That comparison exists nowhere as a single queryable source.

Soko = market in Swahili.

A farmer in Nakuru doesn't know that maize prices in Nairobi are 40% higher that week. Traders know. Farmers don't. This information asymmetry is one of the most costly structural disadvantages facing smallholder farmers. soko-mcp closes it.

The Structural Problem

In mature commodity markets, price discovery is instantaneous — futures markets, satellite price tickers, and SMS alerts exist for every major exchange. A grain elevator in Iowa checks live CME prices before making any offer.

In Kenya, most smallholder farmers receive the price the trader offers, with no independent benchmark to compare against. The result: systematic underpricing at harvest, systematic overpricing at planting.

Information asymmetry is a tax on the poor.

Tools

Tool What it does
commodity_price_query Current price for commodity at a specific market
regional_price_comparison Compare prices across all major Kenya markets
price_trend_analysis 6-month history + 3-month forecast with seasonal model
sell_hold_decision Optimal sell/hold timing given storage costs and price trend
market_overview Multi-commodity price snapshot for a market

Quick Start

pip install soko-mcp       # coming soon to PyPI
soko-mcp                   # starts on stdio

Example Queries for Claude

"What is the current Nairobi maize price?"
"Should I sell my 50 bags of beans now or wait 2 months?"
"Compare potato prices across all Kenya markets"
"Give me a price trend for avocados in Nakuru for the next 3 months"

Research Basis

  • EAGC East Africa Regional Market Monitor
  • World Bank "Information and Communication Technology and Agricultural Markets" (2016)
  • Suri & Jack "Mobile Phones and Agricultural Performance" (2016)

⚠️ DEMO data — synthetic seasonal model. Verify at eagc.org, kalro.org, or local market boards.


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

Part of the East Africa Coordination Stack

This MCP server is part of 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.

Metadata

Release files for soko-mcp 0.1.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for soko-mcp 0.1.5
File Size Uploaded
soko_mcp-0.1.5.tar.gz 12.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for soko-mcp 0.1.5
File Interpreter ABI Platform
soko_mcp-0.1.5-py3-none-any.whl Python 3 none any Details

Total release size: 21.5 kB

Release files / soko_mcp-0.1.5.tar.gz

Download URL soko_mcp-0.1.5.tar.gz
Size 12.0 kB
Tags Source
SHA-256 checksum
How to use checksums
3b44566ce07cdf0481b3802ae440424b2765d4ec659c51530ac0bb8ab8be4b86
BLAKE2b-256 checksum
How to use checksums
5fdc136b57b08d5fe195ed02958a3015357d55c68acdac0c554c7383afdf75df
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.

Transparency log

Release files / soko_mcp-0.1.5-py3-none-any.whl

Download URL soko_mcp-0.1.5-py3-none-any.whl
Size 9.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
28a13995418e2a09a62a9c2af23cea476b9a1dbdd6f5efddda665e318cd999f5
BLAKE2b-256 checksum
How to use checksums
929a8cd4c35b341efd1b8bfd3c5007c13e58dfc0d104a56621b5be51a28e5d2d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.1.5 This release

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page