Mpesa Daraja MCP Server

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?

1. 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.