Mpesa MCP

Give your AI agent the ability to trigger M-Pesa payments, check transaction status, send SMS, and top up airtime across 20+ African telecom networks. Its 5 documented tools cover mpesa, stk. It runs locally over stdio via the published package.

People connecting API integration tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-08-19 · ★ 4 · #90 OF 250 MAINTAINED API INTEGRATION · VERIFIED 2026-08-25

MIT · Python servers · how we verify → /methodology

01 · Install Mpesa MCP

before you install - you'll need

Set MPESA_CONSUMER_KEY, MPESA_CONSUMER_SECRET, MPESA_SHORTCODE, MPESA_PASSKEY, MPESA_CALLBACK_URL, MPESA_SANDBOX, AT_USERNAME, AT_API_KEY before connecting.

Claude Code

claude mcp add gabrielmahia-mpesa-mcp -- uvx mpesa-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "gabrielmahia-mpesa-mcp": {
      "command": "uvx",
      "args": [
        "mpesa-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package mpesa-mcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.gabrielmahia is GitHub-verified and matches the repo owner

03 · What Mpesa MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can check status of an STK Push request, query any M-Pesa transaction by receipt number, and send airtime top-up to any subscriber (KES, NGN, GHS, UGX, etc.).

Capability map

Tools grouped from the project's README - what Mpesa MCP lets an agent do.

Mpesa

3 tools - e.g. Trigger STK Push payment prompt on customer's M-Pesa phone; Check status of an STK Push request; Query any M-Pesa transaction by receipt number

mpesa_stk_push · mpesa_stk_query · mpesa_transaction_status

Sms

1 tool - e.g. Send SMS to 1–1,000 recipients across African networks

sms_send

Airtime

1 tool - e.g. Send airtime top-up to any subscriber (KES, NGN, GHS, UGX, etc.)

airtime_send

Latest releases

v0.2.4 · 2026-07-18

Maintenance release: real server description for the MCP Registry and Glama, interconnect project links on PyPI. No functional changes.

v0.1.8 · 2026-04-26

Fixes License: MIT display on pypi.org. The OSI classifier added in v0.1.7 source required a new wheel build. This release produces that wheel. · bash · pip install mpesa-mcp==0.1.8

v0.1.7 · 2026-04-23

What changed · License updated to MIT. mpesa-mcp and all MCP/SDK infrastructure repos now use MIT for maximum ecosystem compatibility and institutional adoption. · Why · CC-BY-NC-ND 4.0 created legal ambiguity for…

04 · Who maintains Mpesa MCP

mpesa-mcp is maintained by gabrielmahia. We track 33 MCP servers from gabrielmahia - 33 actively maintained, 5 combined GitHub stars, oldest repo from Mar 2026.

05 · Facts

repository: github.com/gabrielmahia/mpesa-mcp
category: API integration - ranked #90 of 250 actively-maintained API integration servers as of 2026-08-25.
release cadence: 1 release in the last 90 days (latest 2026-07-18)
registry: io.github.gabrielmahia/mpesa-mcp (active, first published 2026-03-19 · 4 versions)
packages: pypi:mpesa-mcp

06 · Mpesa MCP FAQ

Is Mpesa MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-19 and it shipped 1 release in the last 90 days. We re-verify nightly.

What can Mpesa MCP do?

With this server connected, an agent can check status of an STK Push request, query any M-Pesa transaction by receipt number, and send airtime top-up to any subscriber (KES, NGN, GHS, UGX, etc.).

How do I install Mpesa MCP?

Run `uvx mpesa-mcp`. The README documents 8 environment variables (MPESA_CONSUMER_KEY, MPESA_CONSUMER_SECRET, MPESA_SHORTCODE…) to set first. Set MPESA_CONSUMER_KEY, MPESA_CONSUMER_SECRET, MPESA_SHORTCODE, MPESA_PASSKEY, MPESA_CALLBACK_URL, MPESA_SANDBOX, AT_USERNAME, AT_API_KEY before connecting. You can also paste the ready-made client config above.

Does Mpesa MCP run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Mpesa MCP

Alternatives to Mpesa MCP

Maintained API integration servers if Mpesa MCP isn't the fit.

More API integration MCP servers · Gatefareio MCP Server · Masv · Mockd · Git Hits · Enrich - Company Domain Intelligence

More Python MCP servers · Galaxy MCP · AI Skill Store · ACMS · Safety Warden · Cloud Audit · see all