Mpesa Daraja MCP Server

@jameskanyiri

About Mpesa Daraja MCP Server

No overview available yet

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mpesa_mcp_server": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Mpesa Daraja MCP Server?

A Python-based server that implements the Mpesa Daraja API functionality using FastMCP. It provides a simple interface to interact with Safaricom's Mpesa Daraja API, starting with OAuth access token generation.

How to use Mpesa Daraja MCP Server?

Install Python 3.7+, clone the repository, create and activate a virtual environment, and install dependencies with pip install -r requirements.txt. 2. Create a .env file with your Mpesa Daraja credentials: MPESA_CONSUMER_KEY, MPESA_CONSUMER_SECRET, PASSKEY, BUSINESS_SHORTCODE, and CALLBACK_URL. 3. Start the server by running python server.py. The server then listens for FastMCP client requests.

Key features of Mpesa Daraja MCP Server

OAuth token generation for Mpesa Daraja API
Secure credential management via environment variables
Comprehensive error handling and logging
FastMCP-based server implementation

Use cases of Mpesa Daraja MCP Server

Authenticating with Safaricom's Mpesa Daraja API for subsequent transactions
Automating access token refresh in M-Pesa integrations
Building AI-powered M-Pesa applications via the Model Context Protocol

FAQ from Mpesa Daraja MCP Server

What does the Mpesa Daraja MCP Server do?

It generates OAuth access tokens for the Safaricom Mpesa Daraja API, handling authentication so you can make further API calls.

What are the prerequisites?

Python 3.7 or higher, Mpesa Daraja API credentials (Consumer Key and Secret), and pip.

What environment variables are required?

MPESA_CONSUMER_KEY, MPESA_CONSUMER_SECRET, PASSKEY, BUSINESS_SHORTCODE, and CALLBACK_URL.

How does the server communicate?

It uses the FastMCP protocol. You start python server.py and interact via a FastMCP client.

Where are credentials stored?

Credentials are read from a .env file in the project root, which is excluded from version control. All API communications use HTTPS.

Frequently asked questions

What does the Mpesa Daraja MCP Server do?

It generates OAuth access tokens for the Safaricom Mpesa Daraja API, handling authentication so you can make further API calls.

What are the prerequisites?

Python 3.7 or higher, Mpesa Daraja API credentials (Consumer Key and Secret), and pip.

What environment variables are required?

`MPESA_CONSUMER_KEY`, `MPESA_CONSUMER_SECRET`, `PASSKEY`, `BUSINESS_SHORTCODE`, and `CALLBACK_URL`.

How does the server communicate?

It uses the FastMCP protocol. You start `python server.py` and interact via a FastMCP client.

Where are credentials stored?

Credentials are read from a `.env` file in the project root, which is excluded from version control. All API communications use HTTPS.

Comments

Basic information

More Other MCP servers

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Inbox Zero AI

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.