0.0.6 • Published 2d agoCLI

@chiahq/mcp

Licence

MIT

Version

0.0.6

Deps

Size

138 kB

Vulns

Weekly

Stars

Summary Dependency Versions

Chia MCP Server

Model Context Protocol (MCP) server for the Chia SDK, enabling AI assistants like Claude to interact with African payment providers.

The MCP server wraps @chiahq/sdk and talks directly to the provider APIs with your own credentials - no Chia account or platform required. Configure the provider environment variables below and any MCP-capable assistant can operate payments against your own PayChangu, PawaPay, or OneKhusa accounts.

Managed recurring billing without running your own stack is what the optional, separate Chia platform is for.

Supported Providers

Unified - Provider-agnostic payment and payout tools that route across whatever is configured (4 tools)
PayChangu - Payment services in Malawi (12 tools)
PawaPay - Mobile money payments across Sub-Saharan Africa (14 tools)
OneKhusa - Enterprise payments in Malawi & Southern Africa (18 tools)

Features

48 comprehensive tools for payment operations
Provider-agnostic payment and payout tools that pick a provider for you
Support for deposits, payouts, refunds, and transfers
Collections and disbursements with approval workflows
Batch payment processing
Balance checking and transaction verification
Mobile money and bank account operations
Sandbox and production environment support

Installation

# Global installation
npm install -g chia-mcp

# Or use directly with npx (no installation required)
npx chia-mcp

Quick Start

1. Get API Credentials

PayChangu: Sign up at https://in.paychangu.com/register
PawaPay: Sign up at https://www.pawapay.io/
OneKhusa: Contact https://onekhusa.com/

2. Configure Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "chia": {
      "command": "npx",
      "args": ["-y", "chia-mcp"],
      "env": {
        "PAYCHANGU_SECRET_KEY": "your-paychangu-secret-key",
        "PAWAPAY_JWT": "your-pawapay-jwt-token",
        "ONEKHUSA_API_KEY": "your-onekhusa-api-key",
        "ONEKHUSA_API_SECRET": "your-onekhusa-api-secret",
        "ONEKHUSA_ORGANISATION_ID": "your-organisation-id",
        "ENVIRONMENT": "DEVELOPMENT"
      }
    }
  }
}

You only need to configure the providers you plan to use.

3. Restart Claude Desktop

Fully quit and restart Claude Desktop to load the MCP server.

4. Start Using

Try commands like:

"Show me PayChangu mobile money operators"
"What's my PawaPay wallet balance?"
"Create a OneKhusa batch disbursement for January salaries"

Available Tools (48 Total)

Unified Tools (4)

Provider-agnostic tools that route across whatever providers are configured, instead of requiring you to pick one. Prefer these unless you need a specific provider.

chia_initiate_payment - Collect a mobile money payment, routed by country and currency
chia_get_payment - Get a payment's status (requires the provider returned by initiate)
chia_send_payout - Send a mobile money payout, routed by country and currency
chia_get_payout - Get a payout's status (requires the provider returned by send)

PayChangu Tools (12)

Payment & Transaction Tools

paychangu_initiate_payment - Start hosted checkout payment
paychangu_verify_transaction - Verify transaction status by tx_ref
paychangu_initiate_direct_charge - Create virtual account for instant payment
paychangu_get_transaction_details - Get direct charge transaction details

Bank Transfer Tools

paychangu_process_bank_transfer - Process bank transfer payment
paychangu_get_supported_banks - List supported banks by currency

Mobile Money & Payout Tools

paychangu_get_mobile_operators - List mobile money operators
paychangu_mobile_money_payout - Send payout to mobile money account
paychangu_get_mobile_payout_details - Check mobile money payout status
paychangu_bank_payout - Send payout to bank account
paychangu_get_bank_payout_details - Check bank payout status
paychangu_list_bank_payouts - List all bank payouts

PawaPay Tools (12)

Deposit Tools

pawapay_request_deposit - Request mobile money deposit
pawapay_get_deposit - Get deposit transaction details
pawapay_resend_deposit_callback - Resend deposit callback

Payout Tools

pawapay_send_payout - Send single payout
pawapay_send_bulk_payout - Send multiple payouts
pawapay_get_payout - Get payout details

Refund Tools

pawapay_create_refund - Create refund request
pawapay_get_refund_status - Get refund status

Wallet & Configuration Tools

pawapay_get_all_balances - Get balances for all countries
pawapay_get_country_balance - Get balance for specific country
pawapay_get_active_config - Get active merchant configuration
pawapay_get_availability - Get correspondent availability status

OneKhusa Tools (18)

Collection Tools

onekhusa_initiate_request_to_pay - Initiate a request-to-pay collection
onekhusa_get_collection_transactions - Get paginated collection transactions
onekhusa_get_collection_transaction - Get specific transaction details

Single Disbursement Tools

onekhusa_add_single_disbursement - Create single payout
onekhusa_approve_single_disbursement - Approve pending disbursement
onekhusa_review_single_disbursement - Mark disbursement as reviewed
onekhusa_reject_single_disbursement - Reject disbursement
onekhusa_get_single_disbursement - Get disbursement details

Batch Disbursement Tools

onekhusa_add_batch_disbursement - Create batch with multiple recipients
onekhusa_approve_batch - Approve batch
onekhusa_review_batch - Mark batch as reviewed
onekhusa_reject_batch - Reject batch
onekhusa_cancel_batch - Cancel batch
onekhusa_transfer_batch_funds - Transfer funds for approved batch
onekhusa_get_batches - Get paginated batches
onekhusa_get_batch - Get batch details
onekhusa_get_batch_transactions - Get transactions within batch

Configuration Tools

onekhusa_check_status - Check OneKhusa service status

Usage Examples

Once configured in Claude Desktop, interact with payment providers through natural language:

Unified Examples

Collect a payment of 50 ZMW from 260971234567 in Zambia, reference order-123

Check the status of payment order-123 (provider: pawapay)

PayChangu Examples

Can you verify PayChangu transaction TX_12345?

Show me all supported mobile money operators for PayChangu

Send a PayChangu mobile money payout of 5000 MWK to 265991234567

PawaPay Examples

What are my PawaPay wallet balances?

Request a PawaPay deposit of 100 ZMW from phone number 260971234567

Send a PawaPay payout of 50 UGX to phone number 256701234567

OneKhusa Examples

Request a payment of 5000 MWK from 265991234567 using OneKhusa

Create a OneKhusa batch disbursement for January salaries with 3 recipients totaling 150000 MWK

Show me all pending OneKhusa batches

Approve batch BATCH_12345 and transfer the funds

Getting API Credentials

PayChangu

Sign up at PayChangu
Complete business verification
Get your secret key from the merchant dashboard
Use test credentials for sandbox environment

PawaPay

Create an account at PawaPay
Complete onboarding and verification
Generate an API token from the dashboard
Use sandbox tokens for testing

OneKhusa

Contact OneKhusa to create a business account
Complete KYC verification
Get your API Key, API Secret, and Organisation ID from the dashboard
Use sandbox environment for testing

Security Notes

Never commit API keys to version control
Use environment variables or secure configuration management
Always use sandbox credentials during development
Keep production credentials secure

Troubleshooting

Tools not appearing in Claude

Check that your claude_desktop_config.json is valid JSON
Verify the file path to the config is correct
Restart Claude Desktop after configuration changes
Check the Claude Desktop logs for errors

Authentication errors

Verify your API credentials are correct
Check that environment variables are properly set
Ensure you're using the correct environment (sandbox vs production)
Check that your account has the necessary permissions

Connection issues

Check your internet connection
Verify the payment provider services are operational
Check for any API rate limiting

Documentation

For full documentation, visit docs.usechia.com.

chia-sdk - The underlying TypeScript SDK