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