Loading
M Pesa Daraja
io.github.Mr-MachariaClaim this server
Power your agent
Add this server
The publisher's own command. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
Local command
uvx mpesa-daraja-mcp==0.1.6Credentials from the publisher
- DARAJA_CONSUMER_KEY — Daraja app Consumer Key
- DARAJA_CONSUMER_SECRET — Daraja app Consumer Secret
- DARAJA_ENV — sandbox (default) or production
- DARAJA_SHORTCODE — Paybill / store number (174379 in sandbox)
- DARAJA_PASSKEY — M-Pesa Express passkey (STK Push)
- DARAJA_INITIATOR_NAME — API operator username (B2C, B2B, status, balance, reversal)
- DARAJA_SECURITY_CREDENTIAL — Encrypted initiator password
- DARAJA_CALLBACK_BASE_URL — Public HTTPS base for callback URLs
- DARAJA_CALLBACK_LISTEN — host:port for the built-in callback receiver
- DARAJA_CALLBACK_TOKEN — 16+ random characters; secret path for callbacks
- DARAJA_TOOLSETS — Comma list: stk,c2b,payouts,ops,qr,ratiba,billmanager
- DARAJA_READ_ONLY — true hides every tool that moves money or writes
- DARAJA_APPROVAL_THRESHOLD — Payouts above this many shillings need approval in the chat
- DARAJA_ALLOWED_RECIPIENTS — Comma list of phones/shortcodes that payouts may go to
- DARAJA_ALLOW_LIVE_MONEY_MOVEMENT — true to allow production charges and payouts
- DARAJA_INITIATOR_PASSWORD — Initiator password, encrypted into SecurityCredential at startup (alternative to DARAJA_SECURITY_CREDENTIAL)
- DARAJA_CERT_PATH — Path to Safaricom's public certificate, used with DARAJA_INITIATOR_PASSWORD
- DARAJA_STATE_DB — Path of the SQLite file that stores request state and callbacks
- DARAJA_OUTPUT_DIR — Directory where generated QR PNGs are saved
- DARAJA_CONFIG_DIR — Directory holding the saved config (default: user config dir)
- DARAJA_DOTENV — Path of a .env file to load instead of the project one
- DARAJA_MCP_TOKEN — Bearer token for HTTP mode (32+ random characters)
- DARAJA_MCP_HOST — HTTP mode bind address (default 127.0.0.1)
- DARAJA_MCP_PORT — HTTP mode port (default 8000)
- DARAJA_FORWARD_URL — Your app's URL: every callback is POSTed on to it, HMAC-signed
- DARAJA_FORWARD_SECRET — HMAC secret for forwarded callbacks (16+ characters)
Claude Code has no install link for a local command. Copy the command below and run it in a terminal.
shClaude Code
DARAJA_CONSUMER_KEY=<secret> DARAJA_CONSUMER_SECRET=<secret> DARAJA_ENV=<value> DARAJA_SHORTCODE=<value> DARAJA_PASSKEY=<secret> DARAJA_INITIATOR_NAME=<value> DARAJA_SECURITY_CREDENTIAL=<secret> DARAJA_CALLBACK_BASE_URL=<value> DARAJA_CALLBACK_LISTEN=<value> DARAJA_CALLBACK_TOKEN=<secret> DARAJA_TOOLSETS=<value> DARAJA_READ_ONLY=<value> DARAJA_APPROVAL_THRESHOLD=<value> DARAJA_ALLOWED_RECIPIENTS=<value> DARAJA_ALLOW_LIVE_MONEY_MOVEMENT=<value> DARAJA_INITIATOR_PASSWORD=<secret> DARAJA_CERT_PATH=<value> DARAJA_STATE_DB=<value> DARAJA_OUTPUT_DIR=<value> DARAJA_CONFIG_DIR=<value> DARAJA_DOTENV=<value> DARAJA_MCP_TOKEN=<secret> DARAJA_MCP_HOST=<value> DARAJA_MCP_PORT=<value> DARAJA_FORWARD_URL=<value> DARAJA_FORWARD_SECRET=<secret> claude mcp add io.github.mr-macharia-mpesa-daraja-mcp -- uvx mpesa-daraja-mcp==0.1.6Run in a terminal.
jsonClaude Desktop
{ "mcpServers": { "io.github.mr-macharia-mpesa-daraja-mcp": { "command": "uvx", "args": [ "mpesa-daraja-mcp==0.1.6" ], "env": { "DARAJA_CONSUMER_KEY": "<secret>", "DARAJA_CONSUMER_SECRET": "<secret>", "DARAJA_ENV": "<value>", "DARAJA_SHORTCODE": "<value>", "DARAJA_PASSKEY": "<secret>", "DARAJA_INITIATOR_NAME": "<value>", "DARAJA_SECURITY_CREDENTIAL": "<secret>", "DARAJA_CALLBACK_BASE_URL": "<value>", "DARAJA_CALLBACK_LISTEN": "<value>", "DARAJA_CALLBACK_TOKEN": "<secret>", "DARAJA_TOOLSETS": "<value>", "DARAJA_READ_ONLY": "<value>", "DARAJA_APPROVAL_THRESHOLD": "<value>", "DARAJA_ALLOWED_RECIPIENTS": "<value>", "DARAJA_ALLOW_LIVE_MONEY_MOVEMENT": "<value>", "DARAJA_INITIATOR_PASSWORD": "<secret>", "DARAJA_CERT_PATH": "<value>", "DARAJA_STATE_DB": "<value>", "DARAJA_OUTPUT_DIR": "<value>", "DARAJA_CONFIG_DIR": "<value>", "DARAJA_DOTENV": "<value>", "DARAJA_MCP_TOKEN": "<secret>", "DARAJA_MCP_HOST": "<value>", "DARAJA_MCP_PORT": "<value>", "DARAJA_FORWARD_URL": "<value>", "DARAJA_FORWARD_SECRET": "<secret>" } } }}claude_desktop_config.json
Local · pypiPublisher installStep-by-step: add this in Claude
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
Host a copy with our keys and logs.
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LaunchTools
Tools
No tool list yet. Remote servers get one after the first health check.
FAQ