Back to Directory/Developer Tools

io.github.gabrielmahia/faida-mcp

MCP server for savings and investment coordination in East Africa (faida = returns)

Developer ToolsPythonv0.1.3

faida-mcp

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


Kenya capital markets via MCP — Treasury bonds, NSE equities, unit trusts, diaspora investment

PyPI License Layer

Install

pip install faida-mcp

What it does

6 MCP tools covering Kenya investment and capital markets. 1st world equivalent: Fidelity / Schwab.

ToolDescription
treasury_bond_calculatorYield, total return, tax calculation for CBK bonds
nse_equities_guideNSE first-time investor guide — CDS, costs, brokers
unit_trust_comparisonRisk/return comparison: MMF, bond, equity funds
diaspora_investment_guideM-Akiba, REITs, NSE access for overseas investors
nse_ipo_guideHow to participate in Kenya IPOs
financial_literacy_kenya50/30/20 rule, compound interest, SACCO vs bank

Usage

# Run as standalone MCP server
faida-mcp

# Or add to Claude Desktop / any MCP client
# Add to your MCP config: {"command": "faida-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. Connect it to africa-coord-bus — the coordination event bus that routes signals between domains automatically.

pip install africa-coord-bus

All 32 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.

Installation

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

bash
uvx faida-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-faida-mcp": {
      "command": "uvx",
      "args": [
        "faida-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

faida-mcppypi

Compatible MCP Clients

io.github.gabrielmahia/faida-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