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, contact us and state that you need the banking API.

What it covers#

Fourteen tools over the banking API: contexts (assignments), credential diagnostics, accounts, balances, payments, statements, an analytical payments report, validating a destination account and sending a transfer with its status lookup.

Eleven of the fourteen only read information. baas_request_statement generates a read-only document and moves no money. The one tool that moves money is baas_send_transfer: it validates the destination account first and requires a confirmation code sent to the merchant's email, so it cannot run on the model's decision alone.

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.

  • Validate BaaS destination accountRead only

    baas_validate_destination

    Validates a destination account before transferring: PHONE for SINPE Móvil or IBAN for account transfer. Returns the holder name the bank confirms.

  • Send BaaS transferSensitive

    baas_send_transfer

    Sends a transfer from the merchant's bank account. Default method: SINPE Móvil (destination by phone). For an account transfer use accountType=IBAN. Requires a 6-digit code by email. Validates per-transfer and daily accumulated limits.

  • BaaS transfer statusRead only

    baas_get_transfer_status

    Checks the current status of a transfer by its payment_id (read only).

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

View as raw Markdown