How do I install Soko?

Soko is a local plugin. Install it using PyPI package: soko-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Soko scored 5.2/10 (moderate risk) in MCP Marketplace's automated security scan. It has 4 high or critical findings to review. It's listed, but review the security report on this page before installing.

What AI apps work with Soko?

Soko uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Soko MCP Server

by Gabrielmahia

Developer ToolsModerate5.2MCP RegistryLocal

Free

Server data from the Official MCP Registry

📊 soko-mcp — Kenya Commodity Price Intelligence MCP Server

About

📊 soko-mcp — Kenya Commodity Price Intelligence MCP Server

Security Report

5.2

Moderate5.2Moderate Risk

soko-mcp is a well-designed, read-only MCP server for commodity price intelligence with no authentication requirements (appropriate for public market data). The codebase is clean, has proper input validation, clear data sources, and appropriate scope. All prices are transparently marked as DEMO/synthetic with explicit verification instructions. No credentials, secrets, or malicious patterns detected. Minor code quality observations do not warrant a lower score. Supply chain analysis found 5 known vulnerabilities in dependencies (1 critical, 3 high severity). Package verification found 1 issue.

5 files analyzed · 9 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

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

Documentation

View on GitHub

From the project's GitHub README.

📊 soko-mcp — Kenya Commodity Price Intelligence MCP Server

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.

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.

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

Soko MCP Server

About

Security Report

Findings (9)Action required

Permissions Required

How to Install

Documentation

📊 soko-mcp — Kenya Commodity Price Intelligence MCP Server

The Structural Problem

Tools

Quick Start

Example Queries for Claude

Research Basis

Part of the East Africa Coordination Stack

IP & Collaboration

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Toleno

mcp-creator-python

MarkItDown

MCP Marketplace

FinAgent