How do I install the daraja mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `DARAJA_CONSUMER_KEY`, `DARAJA_CONSUMER_SECRET`, `DARAJA_SHORTCODE`, `DARAJA_PASSKEY`, `DARAJA_CALLBACK_PUBLIC_URL`, `DARAJA_CALLBACK_PATH_SECRET` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Daraja MCP Server

MCP server for the Safaricom M-Pesa Daraja 3.0 API. Full product surface including M-Pesa Ratiba, a hardened callback receiver, and an offline

Local serverstdio

What is the Daraja MCP Server?

MCP server for the Safaricom M-Pesa Daraja 3.0 API. Full product surface including M-Pesa Ratiba, a hardened callback receiver, and an offline simulator so you can

What it actually does

Covers the full product surface including M-Pesa Ratiba, verifies the source of inbound callbacks, and ships a simulator so you can run every tool without a Safaricom account.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
stk_push	Send a payment prompt. Returns an acknowledgement only.
stk_push_and_wait	Send a prompt and wait for the customer. Returns the receipt.
stk_query	Check the status of a previous prompt.
ratiba_create	Create a standing order for recurring collection.
ratiba_create_and_wait	Create one and wait for the customer to approve.
generate_qr	Generate a dynamic QR code.
b2c_payment	Pay a customer: refunds, withdrawals, salaries.
b2c_payment_and_wait	Same, but returns the settled result.
b2b_payment	Pay a PayBill, a till, or top up a B2C working account.
tax_remittance	Remit tax to KRA against a PRN.
business_to_pochi	Pay a Pochi la Biashara number.
account_balance	Query your business account balance.
transaction_status	Look up any past transaction.
reversal	Reverse a transaction paid into your shortcode.

How to install the Daraja MCP Server

{
  "mcpServers": {
    "daraja": {
      "command": "npx",
      "args": ["-y", "daraja-mcp"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

Variable	Description	Required
DARAJA_CONSUMER_KEY	Credential the server authenticates with.	Yes
DARAJA_CONSUMER_SECRET	Credential the server authenticates with.	Yes
DARAJA_SHORTCODE	Configuration value read at startup.	Optional
DARAJA_PASSKEY	Credential the server authenticates with.	Yes
DARAJA_CALLBACK_PUBLIC_URL	Endpoint or connection string the server talks to.	Yes
DARAJA_CALLBACK_PATH_SECRET	Credential the server authenticates with.	Yes

Example prompts to try

“Use Daraja to stk push.”
“Use Daraja to stk push and wait.”
“Use Daraja to stk query.”

Frequently asked questions

MCP server for the Safaricom M-Pesa Daraja 3.0 API. Full product surface including M-Pesa Ratiba, a hardened callback receiver, and an offline simulator so you can Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.

Alternatives to the Daraja MCP Server

Stripe

Official

Access Stripe billing and payment tools through its MCP server. Connect with OAuth or a supported agent API key and choose the intended account.

Payments & CommerceRemoteTypeScript★ 1.1k

Git

Official

Local repository surgery — status, diffs, commits, branches and history for any repo on disk.

Developer ToolsPython★ 63.0k

Ares

Model Context Protocol servers for Czech & EU due diligence and KYC/AML — company facts, insolvency (ISIR), EU + OFAC sanctions screening, VAT-payer reliability, phoenix & nominee-director…

Legal & ComplianceRemote

Xavio Storefront

Search the public Xavio catalog and create firm checkout quotes.

Payments & CommerceRemote

Nohumans.directory

We buy from x402 endpoints with real USDC and publish delivery outcomes. Check before you spend.