Provides BudgetAgent for county budget analysis using CrewAI framework, enabling AI agents to analyze Kenya's county budget data programmatically.

Integrates with DOI system for dataset citation, providing access to Kenya civic datasets with proper academic attribution through DOI identifiers.

Integrates with Kaggle datasets, providing access to Kenya civic data including parliament records, county budgets, and SACCO registry information.

Distributed as a Python package on PyPI, enabling easy installation and integration of Kenya civic AI tools into Python-based AI agent systems.

Built as a Python SDK, providing programmatic access to Kenya civic data and AI tools through Python interfaces for integration with AI agent systems.

1. Click on "Install Server".

2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.

3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@KenyaMCPServer show me the drought phases for Turkana county"

That's it! The server will respond to your query, and you can continue using it as needed.

Here is a step-by-step guide with screenshots.

pip install civic-agent-kit

from civic_agent_kit import (
 # Data loaders — Kenya's public civic datasets
 KenyaBudgetData, # Controller of Budget — 47 counties
 KenyaParliamentData, # MPs, bills, CDF — 13th Parliament
 KenyaSACCOData, # SASRA SACCO registry
 KenyaDroughtData, # NDMA drought phases

 # Agents
 BudgetAgent, # County budget analysis (CrewAI)
 RightsAgent, # Constitutional rights Q&A (EN/SW)
 DroughtAgent, # Drought + SMS alert agent

 # Protocols
 KenyaMCPServer, # MCP server — wraps all Kenya data as MCP tools
 KenyaA2AServer, # A2A server — Kenya civic skills for agent-to-agent

 # Utils
 KenyaCounties, # All 47 county codes + names
 KiswahiliTranslator, # Simple civic term translations EN↔SW
)

from civic_agent_kit import KenyaBudgetData

budgets = KenyaBudgetData.load()
low_absorption = budgets[budgets['absorption_rate'] < 0.5]
print(low_absorption[['county', 'allocation_kes_m', 'absorption_rate']])

from civic_agent_kit import KenyaA2AServer

server = KenyaA2AServer(host="http://localhost:8000")
server.run() # exposes /.well-known/agent.json + JSON-RPC endpoint

from civic_agent_kit import KenyaMCPServer

# Run alongside mpesa-mcp for full East African AI stack
server = KenyaMCPServer()
server.run()

from civic_agent_kit import RightsAgent

agent = RightsAgent(language="sw")
answer = agent.ask("Haki yangu ya ardhi ni nini?")
print(answer)
# → "Kifungu 40: Kila mtu ana haki ya kupata na kumiliki mali..."

 ┌─────────────────────────────────────┐
 │ Your AI Agent │
 └─────────────┬───────────────────────┘
 │
 ┌──────────────────┴──────────────────────┐
 │ │
 ┌──────▼──────┐ ┌───────▼──────┐
 │ MCP Layer │ │ A2A Layer │
 │ (tools) │ │ (agents) │
 └──────┬───────┘ └───────┬──────┘
 │ │
 ┌─────────┴──────────┐ ┌──────────┴─────────┐
 │ │ │ │
┌────▼────┐ ┌──────▼─────┐ ┌───────▼────┐ ┌──────▼──────┐
│mpesa-mcp│ │KenyaMCP │ │kenya-a2a │ │CivicAgent │
│payments │ │civic data │ │parliament │ │Kit agents │
│SMS │ │budgets │ │budgets │ │budget/rights│
│airtime │ │parliament │ │drought │ │drought │
└─────────┘ └────────────┘ │rights EN/SW│ └─────────────┘
 └────────────┘

from civic_agent_kit import CivicAgentKit

# Full protocol stack
kit = CivicAgentKit(
 mcp_servers=["mpesa-mcp", "wapimaji-mcp"], # MCP
 a2a_registry="kenya-a2a", # A2A
 agui_server="kenya-agui", # AG-UI
 adk_config="kenya-adk", # Google ADK
)