Reference
MCP tools
The twelve read-only tools an AI client can call over MCP, with the arguments each one takes.
This page lists the tools as the server reports them to an AI client.
The server offers 12 tools. All of them only read. Each one runs with the checks of your own account, so a result never shows more than you could open in the app. For how to connect, see Connect Claude and Codex.
search_holds#
Finds holds by status, store name or payout amount, highest risk first. A merchant sees only its own.
status: string, optionalstore: string, optionalmin_amount: number or string, optionalmax_amount: number or string, optionallimit: integer, optional
get_hold#
Reads one hold: the store, the amount, why it was flagged, the documents that would help, the appeal deadline and any appeals.
hold: string, optional. A hold reference. Empty means the hold in the chat.
explain_hold#
Explains why a payout is on hold in plain words. Staff also get the score, its rank and the main reasons behind it. A merchant gets the reasons, the steps and the documents that help, for its own holds only.
hold: string, optional. A hold reference. Empty means the hold in the chat.
hold_orders#
Lists the orders that funded a held payout, or the orders behind one of its reasons.
hold: string, optionalreason: string, optional. A reason code from the hold; lists the orders behind it.limit: integer, optional
hold_party_graph#
Summarises the stores, owners, buyers, devices and bank account linked to a held payout, and how strong each link is.
hold: string, optional. A hold reference. Empty means the hold in the chat.
list_cases#
Lists cases (holds linked by the same owner or bank account), riskiest first, with the money at stake and who has them.
status: string, optionalassigned_to: string, optional. "me", "none" or a staff username.limit: integer, optional
get_case#
Reads one case: its holds, stores and owners, the money at stake, and who has it.
case: string, optional. A case reference. Empty means the case in the chat.
list_appeals#
Lists the appeals on a hold with their status, the merchant's statement, the decision and the files attached.
hold: string, optional
list_payouts#
Lists payouts, newest first. A merchant sees all its own, and a payout under review still shows as paid.
limit: integer, optionalstatus: string, optionalstore: string, optional
get_store#
Finds a store by id or name. A merchant can see only its own stores.
store: string, required. A store id or part of its name.
global_search#
Searches stores by id or name in Arabic or English and lists the open holds on the stores it finds. Up to 10 stores and 10 holds.
text: string, required. A store id or part of a store name.
results#
Reads how the detector did in testing: how many fraud payouts it caught and how many ordinary payouts it held by mistake. These are test results, not real traffic.
Takes no arguments.