{"protocolVersion":"0.3.0","name":"AbaPay","description":"Non-custodial bill-payment agent. Pays airtime, mobile data, electricity, cable TV, education fees and international top-ups across 140+ countries, settled in stablecoins on Celo and Base from a wallet that has granted a bounded, revocable on-chain allowance.","url":"https://agents.abapays.com/api/a2a","preferredTransport":"JSONRPC","version":"1.0.0","documentationUrl":"https://github.com/investorphem/AbaPay#a2a","iconUrl":"https://agents.abapays.com/logo.png","provider":{"organization":"AbaPay","url":"https://agents.abapays.com"},"capabilities":{"streaming":false,"pushNotifications":false,"stateTransitionHistory":false},"defaultInputModes":["text/plain","application/json"],"defaultOutputModes":["text/plain","application/json","image/png"],"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"OAuth 2.1 access token (see /.well-known/oauth-authorization-server) or an AbaPay Agent Hub API key. A token authenticates the connection only — pay_bill additionally requires the wallet PIN on every single call."}},"security":[{"bearer":[]}],"skills":[{"id":"describe_capabilities","name":"Describe capabilities","description":"List what AbaPay can pay (airtime, data, electricity, cable, etc.), any services currently paused, and example requests. Call this first if unsure what is supported.","tags":["discovery","capabilities"],"examples":["What can AbaPay pay for?"]},{"id":"check_balance","name":"Check wallet balance","description":"Check a linked wallet's stablecoin balances and remaining agent spending allowance. Works with no arguments once this connector is authorized via OAuth.","tags":["balance","wallet","stablecoin","celo","base"],"examples":["What is the linked wallet's USDC balance and approved limit?"]},{"id":"list_plans","name":"List purchasable plans","description":"List the REAL, currently purchasable plans for a service that needs one — DATA bundles, CABLE packages, or EDUCATION products (WAEC/JAMB) — with their exact codes and current VTpass prices. ALWAYS call this before pay_bill for these three services and pass back one of the returned codes as variation_code. Never guess a plan, a code, or a price — if this returns nothing usable, say so rather than i","tags":["catalogue","data","cable","education"],"examples":["List MTN data plans"]},{"id":"list_international_options","name":"Browse international options","description":"Browse the REAL, live international top-up catalogue (140+ countries) one level at a time. Call with no country to see supported countries. Add country to see its product types. Add product_type_id to see operators. Add operator_id too to see real, currently purchasable plans with their exact codes, foreign-currency price, and NGN-equivalent cost. ALWAYS call this before pay_bill with service: INT","tags":["international","airtime","data","catalogue"],"examples":["What airtime operators are available in Ghana?"]},{"id":"transaction_history","name":"Recent transaction history","description":"List recent real transactions for the linked wallet — same data as the AbaPay app's History tab (service, provider, amount, status, tx hash). Read-only, no PIN required. The interactive card's own Next/Previous buttons page through results by re-calling this tool with a different offset — pass offset yourself only when asked for something like \"the next page\" or \"transactions before that\" in plain","tags":["history","receipts"],"examples":["What bills were paid recently?"]},{"id":"pay_bill","name":"Pay a bill","description":"Pay a real bill — Nigerian (airtime, data, electricity, cable TV, a WAEC/JAMB education PIN) or international airtime/data across 140+ countries — from the linked wallet, settled on-chain and delivered via the same pipeline as the AbaPay app. For DATA, CABLE (when changing package), and EDUCATION, call list_plans first and use a real variation_code from it. For service: INTERNATIONAL, call list_in","tags":["payment","airtime","data","electricity","cable","education","international"],"examples":["Pay 1000 NGN MTN airtime for 08012345678"]},{"id":"pay_bill_batch","name":"Pay multiple bills at once","description":"Pay airtime or data to multiple recipients in ONE call — the same multi-recipient batch Telegram/WhatsApp/X support (\"send 500 to X and 1000 to Y\"). One PIN authorizes the whole batch. Recipients are grouped by (chain, token); each group's capacity (balance + approved agent limit) is checked against that group's own subtotal — but if ANY group is short, the ENTIRE batch is refused before anything ","tags":["payment","airtime","data","batch"],"examples":["Send 500 NGN airtime to 08011111111 and 1000 NGN to 08033333333"]},{"id":"schedule_bill","name":"Schedule a bill","description":"Set up a recurring or future one-off bill payment — daily/weekly/monthly airtime, data, electricity, or cable — the same automation Telegram/WhatsApp/X support. Validates exactly like pay_bill (call list_plans first for DATA, or CABLE when changing package, to get a real variation_code) and ALWAYS requires the PIN, since this creates a standing spend. Nothing is charged when this tool runs — money","tags":["payment","schedule","recurring","automation"],"examples":["Every Tuesday buy 200 NGN MTN airtime for 08012345678"]},{"id":"list_schedules","name":"List schedules","description":"List active recurring/one-off bill schedules for the linked wallet — same data as the AbaPay app and Telegram/WhatsApp \"show my schedules\". Read-only, no PIN required. Returns each schedule's id — pass that to cancel_schedule to remove one.","tags":["schedule","recurring","automation"],"examples":["What automations do I have set up?"]},{"id":"cancel_schedule","name":"Cancel a schedule","description":"Cancel one or more active schedules for the linked wallet. Call list_schedules first to get a real id. Pass id to cancel exactly one; pass provider to cancel every active schedule for that provider; omit both to cancel ALL active schedules for this wallet. No PIN required, matching chat.","tags":["schedule","recurring","automation"],"examples":["Cancel my MTN airtime schedule"]}]}