wechango-mcp

MCP server for the Wechango unified Mobile Money API. Lets an AI coding assistant (Cursor, Claude Desktop, Claude Code, …) integrate Wechango by calling typed tools instead of guessing from docs — list operators, create a sandbox payment, check its status, and verify a webhook signature.

Sandbox-only by design. This server refuses live keys. Use a test key (sk_test_wc_...). No real money moves.

Tools

| Tool | What it does | |---|---| | wechango_get_started | Returns the integration guide (auth, fields, operator codes, errors, webhooks). Call first. | | wechango_list_countries | Supported countries & currencies. | | wechango_list_operators | Valid operator_code values + limits/fees for a country. | | wechango_create_test_payment | Create a sandbox payment (test mode). | | wechango_get_payment | Fetch a payment's status by id. | | wechango_verify_webhook_signature | Verify a Wechango-Signature locally (HMAC-SHA256). |

In sandbox, the customer number decides the outcome: 699000001 succeeds, 699000010 fails (insufficient funds), 699000011 times out.

Setup

# One-off (no install):
WECHANGO_API_KEY=sk_test_wc_... npx -y wechango-mcp

Claude Desktop / Claude Code (claude_desktop_config.json or .mcp.json)

{
  "mcpServers": {
    "wechango": {
      "command": "npx",
      "args": ["-y", "wechango-mcp"],
      "env": { "WECHANGO_API_KEY": "sk_test_wc_your_test_key" }
    }
  }
}

Cursor (~/.cursor/mcp.json)

Same shape as above.

Configuration

| Env var | Required | Default | |---|---|---| | WECHANGO_API_KEY | yes | — (must be a sk_test_/pk_test_ key) | | WECHANGO_BASE_URL | no | https://api.wechango.seed-innov.com/api/v1 |

Build from source

cd sdks/mcp
npm install
npm run build
WECHANGO_API_KEY=sk_test_wc_... node dist/index.js

Notes

• Errors are surfaced verbatim, including Wechango's self-healing envelope ({ error: { type, code, message, hint } }) so the assistant can read the hint and fix the call automatically.
• Live money and payouts are intentionally NOT exposed here — this is a development/integration aid, not a runtime dependency.