cinetpay-mcp

MCP Server for CinetPay — integrate mobile money payments into Claude, Cursor, and any MCP-compatible AI assistant.

What it does

This MCP server connects your AI assistant to the CinetPay API, enabling natural language interactions with mobile money payments across Africa.

Ask your assistant:

• "What's the balance on the CI account?"

• "Check the status of payment ORDER-12345"

• "Initialize a payment of 5000 XOF for customer jean@email.com"

• "Send 1000 XOF to +2250707000001 via Orange Money"

• "What payment methods are available in Senegal?"

Related MCP server: Daraja MCP

Available Tools

Installation

Claude Code

claude mcp add cinetpay -- npx cinetpay-mcp

Then set your environment variables in .claude/settings.json:

{
  "mcpServers": {
    "cinetpay": {
      "command": "npx",
      "args": ["cinetpay-mcp"],
      "env": {
        "CINETPAY_API_KEY_CI": "sk_test_...",
        "CINETPAY_API_PASSWORD_CI": "your_password"
      }
    }
  }
}

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "cinetpay": {
      "command": "npx",
      "args": ["cinetpay-mcp"],
      "env": {
        "CINETPAY_API_KEY_CI": "sk_test_...",
        "CINETPAY_API_PASSWORD_CI": "your_password"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "cinetpay": {
      "command": "npx",
      "args": ["cinetpay-mcp"],
      "env": {
        "CINETPAY_API_KEY_CI": "sk_test_...",
        "CINETPAY_API_PASSWORD_CI": "your_password"
      }
    }
  }
}

Configuration

Environment Variables

Multi-country (recommended)

Set credentials per country using the pattern CINETPAY_API_KEY_{COUNTRY} / CINETPAY_API_PASSWORD_{COUNTRY}:

# Côte d'Ivoire
CINETPAY_API_KEY_CI=sk_test_...
CINETPAY_API_PASSWORD_CI=your_password

# Sénégal
CINETPAY_API_KEY_SN=sk_test_...
CINETPAY_API_PASSWORD_SN=your_password

# Cameroun
CINETPAY_API_KEY_CM=sk_live_...
CINETPAY_API_PASSWORD_CM=your_password

Single country

CINETPAY_API_KEY=sk_test_...
CINETPAY_API_PASSWORD=your_password
CINETPAY_COUNTRY=CI  # Default: CI

Optional

CINETPAY_BASE_URL=https://api.cinetpay.co  # Default: auto-detected from key prefix
CINETPAY_FORCE_IPV4=true                    # Force IPv4 DNS resolution

Environments

The server auto-detects the environment from your API key prefix.

Supported Countries

Security

• API credentials are read from environment variables only — never hardcoded

• The server uses the cinetpay-js SDK with all its security features:

  • HTTPS enforcement

  • Credential sanitization in logs

  • ES2022 private fields

  • Environment mismatch detection

• Each user runs their own MCP server instance with their own credentials

Support

For CinetPay API questions: support@cinetpay.com

License

MIT