{"id":"kz.qut/mcp","slug":"kz-qut-mcp","title":"Qut Pay (Kaspi QR payments)","description":"Kaspi QR payments (Kazakhstan) via Qut Pay: invoices, refunds, subscriptions, payment links.","version":"0.1.5","publisher":{"kind":"domain","id":"qut.kz","label":"qut.kz","url":"https://qut.kz"},"website":"https://api.qut.kz/docs/guide/en/mcp","repository":"https://github.com/kazprose/qutpay-docs","remotes":[{"type":"streamable-http","url":"https://api.qut.kz/mcp","headers":[{"description":"Bearer <Qut Pay API key: qp_test_… sandbox or qp_live_…>","isRequired":true,"isSecret":true,"name":"Authorization"}]}],"packages":[{"registryType":"npm","registryBaseUrl":"https://registry.npmjs.org","identifier":"@qutpay/mcp","version":"0.1.5","transport":{"type":"stdio"},"environmentVariables":[{"description":"Qut Pay API key (qp_test_… sandbox or qp_live_…), from the cabinet → Integrations → API keys","isRequired":true,"format":"string","isSecret":true,"name":"QUTPAY_API_KEY"},{"description":"API base URL, default https://api.qut.kz","format":"string","default":"https://api.qut.kz","name":"QUTPAY_BASE_URL"}]}],"published":"2026-11-18","updated":"2026-11-18","status":"online","auth":"","latency_ms":1570,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"qutpay_account","title":"Qut Pay account and mode","description":"Returns the organization behind the API key: mode (sandbox or live), tariff and limits, connected Kaspi cashiers, provider status. Call this first.","read_only":true},{"name":"qutpay_create_invoice","title":"Create a Kaspi invoice","description":"Creates an invoice (QR by default, or pushed to the customer's Kaspi.kz app with kind=\"phone\"). Returns payUrl (hosted pay page), qrImageUrl, deepLink, expiresAt (~3 min). Always pass idempotencyKey (e.g. \"order-1001\") so a retry never creates a second invoice. Amount in KZT, ≤ 2 decimals; whole tenge for kind=\"phone\".","read_only":false},{"name":"qutpay_create_topup","title":"Create a balance top-up invoice","description":"Balance top-up for a user of the merchant's own service (AI service, SaaS, website): a QR invoice whose metadata is { ref: userRef, pack, qutpay_kind: \"topup\" }. The merchant keeps the balance in their own system and credits it on the invoice.paid webhook (idempotent by invoice id; subtract on invoice.refunded). Qut Pay holds no balance. Not for digital goods inside Telegram bots (Telegram require","read_only":false},{"name":"qutpay_get_invoice","title":"Get invoice status","description":"Reads one invoice by id (inv_…). live=true asks Kaspi right now instead of the cached status. Status flow: new → pending → paid | failed | expired | cancelled; paid → partially_refunded → refunded.","read_only":true},{"name":"qutpay_list_invoices","title":"List invoices","description":"Lists invoices of the organization, newest first. Filter by status, externalOrderId, date range (ISO), limit ≤ 50, offset for paging.","read_only":true},{"name":"qutpay_cancel_invoice","title":"Cancel an open invoice","description":"Closes a pending invoice. A QR may still be paid until expiresAt — then invoice.paid arrives anyway; handle it.","read_only":false},{"name":"qutpay_refund_invoice","title":"Refund a paid invoice","description":"Full refund (omit amount) or partial refund of a paid invoice. Needs the refunds:write scope. With a LIVE key real money is returned to the customer, so confirm=true is required and the merchant must have asked for this refund explicitly.","read_only":false},{"name":"qutpay_simulate_payment","title":"Simulate a payment (sandbox only)","description":"Completes a sandbox invoice as paid / failed / expired without Kaspi, so the whole flow including the merchant's webhook can be tested. Refuses to run with a live key.","read_only":false},{"name":"qutpay_list_subscriptions","title":"List scheduled invoices (subscriptions)","description":"Lists recurring invoice schedules (subscriptions), newest first. Needs the invoices:read scope.","read_only":true},{"name":"qutpay_get_subscription","title":"Get one subscription","description":"Reads a recurring invoice schedule by id (sub_…): status, amount, interval, nextRunAt, last run and its error, customerUrl. Needs the invoices:read scope.","read_only":true},{"name":"qutpay_create_subscription","title":"Create a subscription (recurring invoices)","description":"Creates a schedule that issues an invoice every N days/weeks/months (gym pass, tutoring, rent, SaaS plan). Each run is an invoice the customer confirms — in the Kaspi.kz app (kind=\"phone\") or through a pay link; Kaspi has no card-on-file auto-debit. The customer's own page (customerUrl) shows the schedule. startAt sets the first run (default now). Needs subscriptions:manage or invoices:write.","read_only":false},{"name":"qutpay_update_subscription","title":"Update a subscription","description":"Changes an active or paused subscription: amount, description, schedule (interval, every, dayOfMonth, nextRunAt), customer, maxRuns, reminders, metadata. Only the fields passed change. Cancelled or finished subscriptions cannot be changed.","read_only":false},{"name":"qutpay_pause_subscription","title":"Pause a subscription","description":"Stops issuing invoices until resumed. Reversible with qutpay_resume_subscription.","read_only":false},{"name":"qutpay_resume_subscription","title":"Resume a paused subscription","description":"Re-activates a paused subscription in the organization's current mode. If the next run time has already passed it is rescheduled from now; catchUp=true issues the missed invoice right away instead.","read_only":false},{"name":"qutpay_cancel_subscription","title":"Cancel a subscription (irreversible)","description":"DESTRUCTIVE: ends the subscription for good — it cannot be resumed or edited afterwards (create a new one instead). Invoices already issued are not affected. To stop it for a while use qutpay_pause_subscription. With a LIVE key confirm=true is required, only after the merchant explicitly asked to cancel.","read_only":false},{"name":"qutpay_run_subscription_now","title":"Issue the next subscription invoice now","description":"Issues the next invoice of a subscription immediately instead of waiting for nextRunAt and moves the schedule on, so the same period is never billed twice. Returns { invoice (with payUrl), run, subscription }.","read_only":false},{"name":"qutpay_create_payment_link","title":"Create a payment link (permanent pay page + QR)","description":"Creates a permanent page /p/<slug> with a printable QR: a fixed price, a customer-entered amount (optionally with min/max), or 2–6 top-up packs shown as buttons (e.g. 1 000 / 5 000 / 10 000 KZT). Every payment becomes an ordinary invoice (webhooks fire as usual; metadata.paymentLinkId). For balance top-ups give packs and send each user to url + \"?ref=<userId>\" — the ref lands in the invoice metada","read_only":false},{"name":"qutpay_list_payment_links","title":"List payment links","description":"Lists the organization's payment links, newest first, with url, qrImageUrl, status, hits (page views) and invoicesCount. Filter by status; limit ≤ 100, offset for paging.","read_only":true},{"name":"qutpay_get_payment_link","title":"Get one payment link","description":"Reads a payment link by id (pl_…): settings, packs, url, qrImageUrl, status, hits (page views) and invoicesCount (live invoices created from it).","read_only":true},{"name":"qutpay_update_payment_link","title":"Update a payment link","description":"Changes title, description, price or limits, packs (null removes them), required fields or successUrl. Only the fields passed change; the slug — and so the printed QR — stays the same. Invoices already created are not affected.","read_only":false},{"name":"qutpay_pause_payment_link","title":"Pause a payment link","description":"The page stays reachable but takes no payments until resumed (customers see that it is paused). Reversible with qutpay_resume_payment_link.","read_only":false},{"name":"qutpay_resume_payment_link","title":"Resume a paused payment link","description":"Lets a paused payment link take payments again.","read_only":false},{"name":"qutpay_delete_payment_link","title":"Delete a payment link (irreversible)","description":"DESTRUCTIVE: removes the link for good — its page and every printed QR stop working and the slug is freed. Invoices already paid through it are kept. To stop it for a while use qutpay_pause_payment_link. With a LIVE key confirm=true is required, only after the merchant explicitly asked to delete.","read_only":false}],"server_info":{"name":"qutpay","version":"0.1.5"},"category":"finance","tags":["hr"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-26","stars":0,"badges":["new"],"sponsor":null,"page":"https://agentsindex.org/agents/kz-qut-mcp/"}