Server definition

Hash: sha256:bb160be55121d978ccc185ed2e629f28e86a6d2d8be9f058a105078a07558e22
What it is: What a remote MCP server returned when asked what it offers: 11 tools

The blob, as servednamed by its sha256

{
  "instructions": "AbaPay: check a linked wallet's stablecoin balance, browse recent transaction history, pay a real bill (one recipient or many at once), or schedule one for later — Nigerian services (airtime, data, electricity, cable) or international airtime/data across 140+ countries — settled on-chain. Call describe_capabilities first. For DATA, CABLE, or EDUCATION, call list_plans before pay_bill/pay_bill_batch/schedule_bill and use one of its real returned codes as variation_code. For service: INTERNATIONAL, call list_international_options first (drills down country -> product type -> operator -> plan) and pass back its exact country/product_type_id/operator_id/variation_code — never guess any of these (INTERNATIONAL cannot be scheduled or batched; pay_bill only). A successful pay_bill returns a rich receipt (image card plus a shareable receipt link) alongside the confirmation text. Use transaction_history to answer 'what did I pay recently' without the human needing to open the app. When the human names 2+ recipients for airtime or data in one request, use pay_bill_batch (one PIN for the whole batch, up to 20 recipients) instead of calling pay_bill repeatedly. Authentication: OAuth 2.1 is supported and preferred — authorize once in the browser and this connection is remembered, so no api_key argument is ever needed again. The api_key created in the AbaPay app under Agent Hub -> MCP remains the fallback for clients that cannot do OAuth. Either way, pay_bill, pay_bill_batch, and schedule_bill ALWAYS require the PIN set when the key was created — OAuth does not remove it. Ask the human for their PIN on every single payment/batch/schedule creation — every single call, never reused from earlier in the conversation. pay_bill and pay_bill_batch execute IMMEDIATELY with no delay of their own — if the human asks to pay 'in N minutes', 'later', 'tomorrow', or on a recurring basis (e.g. 'every Tuesday'), do not call them now; use schedule_bill instead (it charges nothing itself — money only moves later, when the schedule fires and only if the wallet still has a funded allowance then; for multiple recipients, call schedule_bill once per recipient). Use list_schedules/cancel_schedule to view or remove standing schedules (cancelling more than one at a time needs the PIN). Pass a fresh idempotency_key (e.g. a UUID) on every pay_bill, pay_bill_batch and schedule_bill call, and reuse it only to retry that same call. A retry with the same key returns the first result instead of paying twice. Every call that moves or commits money (pay_bill, pay_bill_batch, schedule_bill) is rate-limited per credential on top of the PIN requirement — a 'too many calls' error means slow down and retry shortly, not that anything is broken.",
  "tools": [
    {
      "description": "Cancel active schedules for the linked wallet. Call list_schedules first to get a real id. Pass id to cancel exactly one (no PIN needed). Cancelling several at once — provider for every schedule of that provider, or all: true for every schedule on this wallet — requires the PIN, asked from the human each time. Calling with none of id/provider/all is refused rather than cancelling everything.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "all": {
            "description": "Set true to cancel EVERY active schedule on this wallet. Requires pin. Never inferred — must be passed explicitly.",
            "type": "boolean"
          },
          "api_key": {
            "description": "AbaPay MCP API key. NOT needed when the connector is authorized via OAuth — omit it entirely in that case.",
            "type": "string"
          },
          "id": {
            "description": "The exact schedule id from list_schedules. Cancels only that one schedule. No PIN needed.",
            "type": "string"
          },
          "pin": {
            "description": "The PIN set when the API key was created. Required with provider or all; not needed for a single id.",
            "type": "string"
          },
          "provider": {
            "description": "Cancel every active schedule for this provider, e.g. \"mtn\". Requires pin. Ignored if id is also given.",
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "name": "cancel_schedule",
      "outputSchema": null
    },
    {
      "description": "Check a linked wallet's stablecoin balances and remaining agent spending allowance. Works with no arguments once this connector is authorized via OAuth.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "api_key": {
            "description": "AbaPay MCP API key (starts with aba_mcp_). NOT needed when the connector is authorized via OAuth — omit it entirely in that case; only supply it if this server asked you to authenticate and OAuth is unavailable.",
            "type": "string"
          },
          "chain": {
            "description": "Defaults to the chain approved when the key was created.",
            "enum": [
              "CELO",
              "BASE"
            ],
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "name": "check_balance",
      "outputSchema": null
    },
    {
      "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.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "describe_capabilities",
      "outputSchema": null
    },
    {
      "description": "Look up one payment by its reference — the transaction hash (0x…) or the request id a payment returned — and get its current status in plain words: delivered, still being confirmed, failed, or refunded, including where any refund stands. Only finds payments made by the linked wallet. Read-only, no PIN required. Use this instead of paying again when a pay_bill result was lost.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "api_key": {
            "description": "AbaPay MCP API key. NOT needed when the connector is authorized via OAuth — omit it entirely in that case.",
            "type": "string"
          },
          "reference": {
            "description": "The transaction hash (0x…) or request id of the payment.",
            "type": "string"
          }
        },
        "required": [
          "reference"
        ],
        "type": "object"
      },
      "name": "get_payment_status",
      "outputSchema": null
    },
    {
      "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: INTERNATIONAL, and pass back the exact country/product_type_id/operator_id/variation_code shown — never guess any of them. Only plans marked fixed-price can be paid via pay_bill right now; flexible-amount plans must be completed in the AbaPay app.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "country": {
            "description": "Country name or ISO code, e.g. \"Ghana\" or \"GH\". Omit to list all supported countries.",
            "type": "string"
          },
          "operator_id": {
            "description": "An operator_id returned for this country + product_type_id — the network to top up. Omit to list operators.",
            "type": "string"
          },
          "product_type_id": {
            "description": "A product_type_id returned for this country — e.g. which kind of top-up (airtime vs a data bundle). Omit to list the country's product types.",
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "name": "list_international_options",
      "outputSchema": null
    },
    {
      "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 inventing one.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "provider": {
            "description": "e.g. mtn, airtel, glo, 9mobile (data); dstv, gotv, startimes (cable); waec, waec-registration, jamb (education)",
            "type": "string"
          },
          "service": {
            "description": "Which service to list plans for. Electricity and airtime are free-amount and have no plan list.",
            "enum": [
              "DATA",
              "CABLE",
              "EDUCATION"
            ],
            "type": "string"
          }
        },
        "required": [
          "service",
          "provider"
        ],
        "type": "object"
      },
      "name": "list_plans",
      "outputSchema": null
    },
    {
      "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.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "api_key": {
            "description": "AbaPay MCP API key. NOT needed when the connector is authorized via OAuth — omit it entirely in that case.",
            "type": "string"
          }
        },
        "required": [],
        "type": "object"
      },
      "name": "list_schedules",
      "outputSchema": null
    },
    {
      "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_international_options first and pass back its exact country/product_type_id/operator_id/variation_code — never guess any of these. ALWAYS requires the PIN — including when this connector is authorized via OAuth; ask the human for it every time and never guess or reuse a remembered one. Money moves for real — only call this once the human has clearly confirmed the exact amount, provider, and account. EXECUTES IMMEDIATELY, with no delay/schedule parameter of any kind — there is no way to queue this call for later on this connection. If the human asks to pay \"in N minutes\", \"later today\", \"tomorrow\", or any other future time, do NOT call this now: ask them to confirm they want it sent immediately instead, or tell them delayed/recurring automations can only be set up from the AbaPay app or by messaging the AbaPay agent on Telegram/WhatsApp/X — never silently pay right away when a delay was requested.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "account_number": {
            "description": "Phone number (airtime/data), meter number (electricity), smartcard/IUC number (cable), JAMB profile ID (education: jamb), the buyer's phone number (education: waec), or the destination phone number abroad (international)",
            "type": "string"
          },
          "amount_ngn": {
            "description": "Amount in Naira. Not needed for service: INTERNATIONAL — the NGN-equivalent is derived from the live plan you picked via list_international_options.",
            "type": "number"
          },
          "api_key": {
            "description": "AbaPay MCP API key. NOT needed when the connector is authorized via OAuth — omit it entirely in that case.",
            "type": "string"
          },
          "chain": {
            "description": "Defaults to the chain approved when the API key was created. Only override this if the default chain lacks balance/allowance and check_balance shows funds on the other one.",
            "enum": [
              "CELO",
              "BASE"
            ],
            "type": "string"
          },
          "country": {
            "description": "Required for service: INTERNATIONAL — country name or ISO code, from list_international_options.",
            "type": "string"
          },
          "customer_email": {
            "description": "Required for service: INTERNATIONAL (the receipt goes here). Optional otherwise.",
            "type": "string"
          },
          "customer_name": {
            "description": "Optional — used for the receipt if known",
            "type": "string"
          },
          "idempotency_key": {
            "description": "Optional, strongly recommended: a unique id you choose for THIS payment (8-128 chars, e.g. a UUID). Retrying with the same key returns the first result instead of paying again; reusing it with different arguments is refused (409). Without one, an identical call within 2 minutes is treated as a retry.",
            "type": "string"
          },
          "meter_type": {
            "description": "Required for ELECTRICITY",
            "enum": [
              "prepaid",
              "postpaid"
            ],
            "type": "string"
          },
          "operator_id": {
            "description": "Required for service: INTERNATIONAL — from list_international_options.",
            "type": "string"
          },
          "pin": {
            "description": "The PIN set when the API key was created (6 digits for new keys). Required on EVERY payment, including over an OAuth connection — ask the human for it each time.",
            "type": "string"
          },
          "product_type_id": {
            "description": "Required for service: INTERNATIONAL — from list_international_options.",
            "type": "string"
          },
          "provider": {
            "description": "e.g. mtn, airtel, glo, ikeja-electric, dstv, gotv, startimes, waec, waec-registration, jamb. Not used for service: INTERNATIONAL — use country/product_type_id/operator_id instead.",
            "type": "string"
          },
          "service": {
            "description": "Which kind of bill",
            "enum": [
              "AIRTIME",
              "DATA",
              "ELECTRICITY",
              "CABLE",
              "EDUCATION",
              "INTERNATIONAL"
            ],
            "type": "string"
          },
          "token": {
            "description": "Which stablecoin to pay with. Defaults to the token approved when the API key was created. If that one is short on balance or on-chain allowance, call check_balance first to see what else is available on this chain, then retry with this field set — e.g. if USD₮ is short but the wallet holds USDC with its own approved limit, pass token: \"USDC\".",
            "enum": [
              "USD₮",
              "USDC",
              "USA₮"
            ],
            "type": "string"
          },
          "variation_code": {
            "description": "Plan/bundle/product code — required for DATA, EDUCATION, and INTERNATIONAL, and for CABLE when changing package (not needed to renew the current one)",
            "type": "string"
          }
        },
        "required": [
          "pin",
          "service",
          "account_number"
        ],
        "type": "object"
      },
      "name": "pay_bill",
      "outputSchema": null
    },
    {
      "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 moves (all-or-nothing on capacity; paying 6 of 8 recipients because the 7th was under-funded is worse than one clear error up front). Once capacity clears, recipients are paid one at a time and the response reports each individually, since a single vend failure partway through must not be reported as if the whole batch failed. AIRTIME and DATA only — electricity, cable, education, and international are not batchable; call pay_bill for those, one at a time. For DATA, call list_plans first and give each recipient needing one its own real variation_code. EXECUTES IMMEDIATELY: no delay/schedule option, same as pay_bill — for a delayed/recurring batch, call schedule_bill once per recipient instead.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "api_key": {
            "description": "AbaPay MCP API key. NOT needed when the connector is authorized via OAuth — omit it entirely in that case.",
            "type": "string"
          },
          "chain": {
            "description": "Default chain for recipients that don't set their own. Falls back to the chain approved when the API key was created.",
            "enum": [
              "CELO",
              "BASE"
            ],
            "type": "string"
          },
          "customer_email": {
            "description": "Optional — used for receipts if known, applies to the whole batch.",
            "type": "string"
          },
          "idempotency_key": {
            "description": "Optional, strongly recommended: a unique id you choose for THIS payment (8-128 chars, e.g. a UUID). Retrying with the same key returns the first result instead of paying again; reusing it with different arguments is refused (409). Without one, an identical call within 2 minutes is treated as a retry.",
            "type": "string"
          },
          "pin": {
            "description": "The PIN set when the API key was created (6 digits for new keys). Required once for the whole batch.",
            "type": "string"
          },
          "recipients": {
            "description": "At least 2 recipients (a single recipient should just use pay_bill), at most 20 per call — split a larger batch across several calls.",
            "items": {
              "additionalProperties": false,
              "properties": {
                "account_number": {
                  "description": "Phone number to top up",
                  "type": "string"
                },
                "amount_ngn": {
                  "description": "Amount in Naira for this recipient",
                  "type": "number"
                },
                "chain": {
                  "description": "Overrides the batch-level chain for this recipient only.",
                  "enum": [
                    "CELO",
                    "BASE"
                  ],
                  "type": "string"
                },
                "provider": {
                  "description": "e.g. mtn, airtel, glo, 9mobile",
                  "type": "string"
                },
                "service": {
                  "description": "Only AIRTIME and DATA are batchable.",
                  "enum": [
                    "AIRTIME",
                    "DATA"
                  ],
                  "type": "string"
                },
                "token": {
                  "description": "Overrides the batch-level token for this recipient only.",
                  "enum": [
                    "USD₮",
                    "USDC",
                    "USA₮"
                  ],
                  "type": "string"
                },
                "variation_code": {
                  "description": "Required for DATA — call list_plans first and pass a real code for this recipient's plan.",
                  "type": "string"
                }
              },
              "required": [
                "service",
                "provider",
                "account_number",
                "amount_ngn"
              ],
              "type": "object"
            },
            "maxItems": 20,
            "minItems": 2,
            "type": "array"
          },
          "token": {
            "description": "Default token for recipients that don't set their own. Falls back to the token approved when the API key was created.",
            "enum": [
              "USD₮",
              "USDC",
              "USA₮"
            ],
            "type": "string"
          }
        },
        "required": [
          "pin",
          "recipients"
        ],
        "type": "object"
      },
      "name": "pay_bill_batch",
      "outputSchema": null
    },
    {
      "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 only moves later, when the schedule actually fires, and only if the wallet still has a funded on-chain allowance at that time. If the approved agent limit already covers the amount right now, the schedule is created to auto-pay itself each time it is due; otherwise it is saved as notify-only and someone must call pay_bill manually when it comes due — the response says which. EDUCATION and INTERNATIONAL cannot be scheduled; pay those directly with pay_bill. Use list_schedules to see what is set up and cancel_schedule to remove one.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "account_number": {
            "description": "Phone number (airtime/data), meter number (electricity), or smartcard/IUC number (cable)",
            "type": "string"
          },
          "amount_ngn": {
            "description": "Amount in Naira to charge each time the schedule runs.",
            "type": "number"
          },
          "api_key": {
            "description": "AbaPay MCP API key. NOT needed when the connector is authorized via OAuth — omit it entirely in that case.",
            "type": "string"
          },
          "chain": {
            "description": "Defaults to the chain approved when the API key was created.",
            "enum": [
              "CELO",
              "BASE"
            ],
            "type": "string"
          },
          "customer_email": {
            "description": "Where to send a notification when this runs. MCP has no persistent channel to message back into a conversation — without this, you'll need to poll list_schedules or transaction_history yourself to see what happened.",
            "type": "string"
          },
          "day_of_month": {
            "description": "Required when frequency is \"monthly\" — 1 through 28.",
            "type": "number"
          },
          "day_of_week": {
            "description": "Required when frequency is \"weekly\" — 0 (Sunday) through 6 (Saturday).",
            "type": "number"
          },
          "frequency": {
            "description": "How often this runs. \"once\" fires exactly one time, schedule_in_minutes from now.",
            "enum": [
              "daily",
              "weekly",
              "monthly",
              "once"
            ],
            "type": "string"
          },
          "idempotency_key": {
            "description": "Optional, strongly recommended: a unique id you choose for THIS payment (8-128 chars, e.g. a UUID). Retrying with the same key returns the first result instead of paying again; reusing it with different arguments is refused (409). Without one, an identical call within 2 minutes is treated as a retry.",
            "type": "string"
          },
          "meter_type": {
            "description": "Required for ELECTRICITY",
            "enum": [
              "prepaid",
              "postpaid"
            ],
            "type": "string"
          },
          "pin": {
            "description": "The PIN set when the API key was created (6 digits for new keys). Required to create a schedule, same as pay_bill.",
            "type": "string"
          },
          "provider": {
            "description": "e.g. mtn, airtel, glo, 9mobile, ikeja-electric, dstv, gotv, startimes",
            "type": "string"
          },
          "schedule_in_minutes": {
            "description": "Required when frequency is \"once\" — minutes from now to run it a single time.",
            "type": "number"
          },
          "service": {
            "description": "Which kind of bill to schedule. EDUCATION and INTERNATIONAL are not schedulable — use pay_bill directly for those.",
            "enum": [
              "AIRTIME",
              "DATA",
              "ELECTRICITY",
              "CABLE"
            ],
            "type": "string"
          },
          "token": {
            "description": "Defaults to the token approved when the API key was created.",
            "enum": [
              "USD₮",
              "USDC",
              "USA₮"
            ],
            "type": "string"
          },
          "variation_code": {
            "description": "Plan/bundle/product code — required for DATA, and for CABLE when changing package (not needed to renew the current one). Get a real one from list_plans first.",
            "type": "string"
          }
        },
        "required": [
          "pin",
          "service",
          "account_number",
          "amount_ngn",
          "frequency"
        ],
        "type": "object"
      },
      "name": "schedule_bill",
      "outputSchema": null
    },
    {
      "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 text.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "api_key": {
            "description": "AbaPay MCP API key. NOT needed when the connector is authorized via OAuth — omit it entirely in that case.",
            "type": "string"
          },
          "limit": {
            "description": "How many recent transactions to return. Defaults to 10, max 25.",
            "type": "number"
          },
          "offset": {
            "description": "How many of the most recent transactions to skip before listing — 0 (default) starts at the newest. Used for paging: offset=10 with the default limit gets the next 10 after the first page.",
            "type": "number"
          }
        },
        "required": [],
        "type": "object"
      },
      "name": "transaction_history",
      "outputSchema": null
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:bb160be55121d978ccc185ed2e629f28e86a6d2d8be9f058a105078a07558e22 | sha256sum