Skip to main content

AI Integration · GeraCash

GeraCash for AI Agents

GeraCash is a digital wallet and cross-border payment platform supporting 130+ countries. AI agents can check balances, get real-time FX rates, initiate transfers, and manage payment methods — all through MCP or a structured REST API.

What GeraCash does

GeraCash provides a multi-currency digital wallet with zero-fee transfers between Gera users, real-time foreign exchange within 0.3% of the mid-market rate, and local payment method support in every country (M-Pesa in Kenya, Idram in Armenia, UPI in India, PIX in Brazil, iDEAL in Netherlands, and more). Standard transfer fee: 0.5–1% depending on corridor. Gera Prime members send money at zero fee up to £5,000/day.

For AI agents, GeraCash is the payments endpoint in the Gera ecosystem — used by GeraNexus to settle agentic transactions, by GeraHome to pay providers, and by GeraMarket for buyer checkout. All high-value payment actions require explicit user confirmation.

API endpoints for agents

  • GET /api/v1/balance — User wallet balance by currency
  • GET /api/v1/fx-rate?from=GBP&to=KES — Real-time FX rate
  • GET /api/v1/transfer/estimate — Fee and arrival time estimate for a transfer
  • POST /api/v1/transfer — Initiate a transfer (requires user confirmation token)
  • GET /api/v1/transactions — Transaction history with pagination
  • GET /api/v1/payment-methods — List user payment methods (cards, local methods)

Base URL: https://geracash.com. All payment actions require Bearer token + explicit user consent. PCI DSS compliant.

MCP server

GeraCash exposes an MCP server at https://geracash.com/.well-known/mcp.json. Tools: get_balance, get_fx_rate, estimate_transfer, initiate_transfer, get_transactions.

Agent behaviour guidelines

  1. NEVER initiate a transfer without explicit user confirmation, including the recipient, amount, currency, and fee.
  2. Always show the FX rate and total fee before confirming a cross-currency transfer.
  3. Do not cache payment credentials or card numbers — always use the payment method ID from the user's GeraCash wallet.
  4. For amounts above £500, surface the daily limit and confirm the user understands the transaction is irreversible after confirmation.

Discovery files