Safaricom M-Pesa Daraja tools: STK Push, C2B, B2C, B2B, QR, Ratiba. Sandbox-first, idempotent.
To add M-Pesa Daraja to Claude, run the install command below or copy the ready-made config for Claude Code, Claude Desktop, Cursor and VS Code further down. Restart your client after adding it and its tools show up in your next conversation. It needs 26 environment variables, listed below.
Install
uvx mpesa-daraja-mcp@0.1.6Environment variables
DARAJA_CONSUMER_KEYSet in your MCP configDARAJA_CONSUMER_SECRETSet in your MCP configDARAJA_ENVSet in your MCP configDARAJA_SHORTCODESet in your MCP configDARAJA_PASSKEYSet in your MCP configDARAJA_INITIATOR_NAMESet in your MCP configDARAJA_SECURITY_CREDENTIALSet in your MCP configDARAJA_CALLBACK_BASE_URLSet in your MCP configDARAJA_CALLBACK_LISTENSet in your MCP configDARAJA_CALLBACK_TOKENSet in your MCP configDARAJA_TOOLSETSSet in your MCP configDARAJA_READ_ONLYSet in your MCP configDARAJA_APPROVAL_THRESHOLDSet in your MCP configDARAJA_ALLOWED_RECIPIENTSSet in your MCP configDARAJA_ALLOW_LIVE_MONEY_MOVEMENTSet in your MCP configDARAJA_INITIATOR_PASSWORDSet in your MCP configDARAJA_CERT_PATHSet in your MCP configDARAJA_STATE_DBSet in your MCP configDARAJA_OUTPUT_DIRSet in your MCP configDARAJA_CONFIG_DIRSet in your MCP configDARAJA_DOTENVSet in your MCP configDARAJA_MCP_TOKENSet in your MCP configDARAJA_MCP_HOSTSet in your MCP configDARAJA_MCP_PORTSet in your MCP configDARAJA_FORWARD_URLSet in your MCP configDARAJA_FORWARD_SECRETSet in your MCP configInstall with your client
claude mcp add m-pesa-daraja --env DARAJA_CONSUMER_KEY=<YOUR_DARAJA_CONSUMER_KEY> --env DARAJA_CONSUMER_SECRET=<YOUR_DARAJA_CONSUMER_SECRET> --env DARAJA_ENV=<YOUR_DARAJA_ENV> --env DARAJA_SHORTCODE=<YOUR_DARAJA_SHORTCODE> --env DARAJA_PASSKEY=<YOUR_DARAJA_PASSKEY> --env DARAJA_INITIATOR_NAME=<YOUR_DARAJA_INITIATOR_NAME> --env DARAJA_SECURITY_CREDENTIAL=<YOUR_DARAJA_SECURITY_CREDENTIAL> --env DARAJA_CALLBACK_BASE_URL=<YOUR_DARAJA_CALLBACK_BASE_URL> --env DARAJA_CALLBACK_LISTEN=<YOUR_DARAJA_CALLBACK_LISTEN> --env DARAJA_CALLBACK_TOKEN=<YOUR_DARAJA_CALLBACK_TOKEN> --env DARAJA_TOOLSETS=<YOUR_DARAJA_TOOLSETS> --env DARAJA_READ_ONLY=<YOUR_DARAJA_READ_ONLY> --env DARAJA_APPROVAL_THRESHOLD=<YOUR_DARAJA_APPROVAL_THRESHOLD> --env DARAJA_ALLOWED_RECIPIENTS=<YOUR_DARAJA_ALLOWED_RECIPIENTS> --env DARAJA_ALLOW_LIVE_MONEY_MOVEMENT=<YOUR_DARAJA_ALLOW_LIVE_MONEY_MOVEMENT> --env DARAJA_INITIATOR_PASSWORD=<YOUR_DARAJA_INITIATOR_PASSWORD> --env DARAJA_CERT_PATH=<YOUR_DARAJA_CERT_PATH> --env DARAJA_STATE_DB=<YOUR_DARAJA_STATE_DB> --env DARAJA_OUTPUT_DIR=<YOUR_DARAJA_OUTPUT_DIR> --env DARAJA_CONFIG_DIR=<YOUR_DARAJA_CONFIG_DIR> --env DARAJA_DOTENV=<YOUR_DARAJA_DOTENV> --env DARAJA_MCP_TOKEN=<YOUR_DARAJA_MCP_TOKEN> --env DARAJA_MCP_HOST=<YOUR_DARAJA_MCP_HOST> --env DARAJA_MCP_PORT=<YOUR_DARAJA_MCP_PORT> --env DARAJA_FORWARD_URL=<YOUR_DARAJA_FORWARD_URL> --env DARAJA_FORWARD_SECRET=<YOUR_DARAJA_FORWARD_SECRET> -- uvx mpesa-daraja-mcp@0.1.6
Run this in a terminal to add the server to Claude Code.
What this does
M-Pesa Daraja exposes a set of tools to Claude over the Model Context Protocol. After you add it to claude_desktop_config.json (snippet above) and restart Claude Desktop, those tools become callable inside any conversation.
Requirements
This server needs the following environment variables to be set before it can run:
DARAJA_CONSUMER_KEY DARAJA_CONSUMER_SECRET DARAJA_ENV DARAJA_SHORTCODE DARAJA_PASSKEY DARAJA_INITIATOR_NAME DARAJA_SECURITY_CREDENTIAL DARAJA_CALLBACK_BASE_URL DARAJA_CALLBACK_LISTEN DARAJA_CALLBACK_TOKEN DARAJA_TOOLSETS DARAJA_READ_ONLY DARAJA_APPROVAL_THRESHOLD DARAJA_ALLOWED_RECIPIENTS DARAJA_ALLOW_LIVE_MONEY_MOVEMENT DARAJA_INITIATOR_PASSWORD DARAJA_CERT_PATH DARAJA_STATE_DB DARAJA_OUTPUT_DIR DARAJA_CONFIG_DIR DARAJA_DOTENV DARAJA_MCP_TOKEN DARAJA_MCP_HOST DARAJA_MCP_PORT DARAJA_FORWARD_URL DARAJA_FORWARD_SECRET
Set these via the env object in your MCP config (see claude_desktop_config.json snippet above).
Frequently asked questions
How do I install M-Pesa Daraja?
Run the Claude Code command in the install section to add M-Pesa Daraja to Claude Code, or copy the ready-made config for your client from the install section on this page. Restart your client afterwards and the tools appear in your next conversation.
Which clients work with M-Pesa Daraja?
This page carries setup and config for Claude Code, Claude Desktop, Cursor and VS Code. Any other MCP client that accepts a standard server config can connect to M-Pesa Daraja as well.
Does M-Pesa Daraja need an API key?
Yes. Before it can run, set these environment variables: DARAJA_CONSUMER_KEY, DARAJA_CONSUMER_SECRET, DARAJA_ENV, DARAJA_SHORTCODE, DARAJA_PASSKEY, DARAJA_INITIATOR_NAME, DARAJA_SECURITY_CREDENTIAL, DARAJA_CALLBACK_BASE_URL, DARAJA_CALLBACK_LISTEN, DARAJA_CALLBACK_TOKEN, DARAJA_TOOLSETS, DARAJA_READ_ONLY, DARAJA_APPROVAL_THRESHOLD, DARAJA_ALLOWED_RECIPIENTS, DARAJA_ALLOW_LIVE_MONEY_MOVEMENT, DARAJA_INITIATOR_PASSWORD, DARAJA_CERT_PATH, DARAJA_STATE_DB, DARAJA_OUTPUT_DIR, DARAJA_CONFIG_DIR, DARAJA_DOTENV, DARAJA_MCP_TOKEN, DARAJA_MCP_HOST, DARAJA_MCP_PORT, DARAJA_FORWARD_URL, DARAJA_FORWARD_SECRET. They go in the env block of your MCP config.
Imported from the Official MCP Registry. The details above come from the registry entry; the maker can claim this listing to correct them, add docs, and see its traffic.
Is this your MCP server?
Claim this listing to see its traffic, fix details yourself, and skip the review queue on future updates.
Add this badge to your README
Show visitors this server is listed in the ClaudeRules directory. The badge links straight to this listing.
[](https://clauderules.net/mcp/io-github-mr-macharia-mpesa-daraja-mcp)<a href="https://clauderules.net/mcp/io-github-mr-macharia-mpesa-daraja-mcp" target="_blank" rel="noopener noreferrer"><img src="https://clauderules.net/api/badge/io-github-mr-macharia-mpesa-daraja-mcp" alt="Listed on clauderules.net" /></a>More DevTools MCP servers
GitHub
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Serena MCP: the IDE for your agent
A powerful toolkit for coding, providing semantic retrieval and editing capabilities.
Figma-Context-MCP
Give your coding agent access to your Figma data. Implement designs in any framework in one-shot.
Inbox Zero
Search Gmail and Outlook, save drafts, manage email rules, and view email stats.