TilopayDeveloper and AI Agents
Credentials

Banking tools

Write

These tools are not enabled by default. They are turned on on request and only work for users with Tilopay banking API credentials registered by Tilopay on the server side. Standard MCP access does not include the group; and if a tool is called without those credentials, it replies that they do not exist. To request it, use the access form and state that you need the banking API.

What it covers#

Eleven read tools over the banking API: contexts (assignments), credential diagnostics, accounts, balances, payments, statements and an analytical payments report.

None of these tools initiates, approves or reverses transfers. They only extract information. The only one that is not a pure read is baas_request_statement, which generates a read-only document: it moves no money.

Accounts are identified with accountType: "IBAN" plus accountValue, dates are RFC 3339 (2026-01-01T00:00:00Z) and assignmentId is only needed when the user has several contexts.

Tools#

These tools are enabled on request and only work for users with Tilopay banking API credentials. They are not part of the default MCP access: Tilopay enables the group case by case. Requires: Credenciales del API bancario de Tilopay registradas por Tilopay para ese usuario.
  • Other BaaS operations

    baas_list_assignmentsbaas_diagnosticsbaas_list_accountsbaas_get_balancebaas_get_statement_status

    Assignments, credential diagnostics, account listing, balance of one account and status of a statement request.

  • Banking API account balancesRead only

    baas_list_balances

    Lists the real-time balances of the accessible accounts: account, amounts and cut-off date.

  • List banking API paymentsRead only

    baas_list_payments

    Reads the payments of an owned account identified by IBAN, with date, status, currency, method and direction filters. Cursor pagination.

  • Find a paymentRead only

    baas_search_payment

    Finds a payment inside an account by exactly one of: paymentId (UUID), publicId (number) or clientReference. Sending more than one returns an error.

  • Payment detailRead only

    baas_get_payment

    Gets the detail of a banking API payment from its internal UUID, read only.

  • Request an account statementWrite

    baas_request_statement

    Requests the generation of an account statement for a banking API account, with a 60-day maximum range. It moves no money: it generates a read-only document and returns request_id with status PENDING.

  • Banking API payments analystRead only

    baas_analyze_payments

    Analyses, read only, the payments of an account in a date range and returns a natural-language report: success, failures, reversals, net amounts and recommendations. It runs a language model over the computed figures.

Last verified: 2026-09-03 · Owner: equipo-integraciones

View as raw Markdown

Tilopay

© 2026 Tilopay – Se advierte al público que, Tilopay Soluciones Comerciales Limitada es supervisada solamente en materia de prevención de legitimación de capitales, financiamiento al terrorismo y financiamiento de la proliferación de armas de destrucción masiva, y además se encuentra sujeta a disposiciones vinculantes de la Unidad de Inteligencia Financiera del Instituto Costarricense sobre Drogas. Por lo tanto, la Sugef no supervisa en materia financiera a Tilopay Soluciones Comerciales Limitada, ni los negocios que ofrece, ni su seguridad, estabilidad o solvencia. Asimismo, Tilopay Soluciones Comerciales Limitada no cuenta con el respaldo del Fondo de Garantías que ha sido creado para asegurar los fondos de las entidades financieras.