Servers Playground How we check Add a server Log in

Xaalis

Working Security A

org.xaalis/mcpv0.1.0 Domain verified

Wave and Orange Money payments in Senegal: payment links, refunds, subscriptions, agent payouts.

Finance & Payments

Watch Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

Authorization (optional)

Bearer <Xaalis key>, or sign in with OAuth (no header)

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

xaalis_advance_subscription

Sandbox only: jump to the subscription's next billing event (next invoice, due date or end of grace) to test renewals without waiting.

idstring, required

Subscription id (sub_…)

idempotency_keystring, required

Stable key for this business action (e.g. order-1042). Reuse the SAME key when retrying; a new key creates a new operation.

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Xaalis MCP server | mcptry

Tools (28)

xaalis_advance_subscription

Sandbox only: jump to the subscription's next billing event (next invoice, due date or end of grace) to test renewals without waiting.

Argument	Type	Description
id*	string	Subscription id (sub_…)
idempotency_key*	string	Stable key for this business action (e.g. order-1042). Reuse the SAME key when retrying; a new key creates a new operation.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id",
    "idempotency_key"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 3,
      "description": "Subscription id (sub_…)"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[\\x21-\\x7e]+$",
      "maxLength": 255,
      "minLength": 1,
      "description": "Stable key for this business action (e.g. order-1042). Reuse the SAME key when retrying; a new key creates a new operation."
    }
  }
}

xaalis_cancel_subscription

Cancel now (voids the unpaid invoice if checkout hasn't started) or at the end of the current period.

destructive

Argument	Type	Description
id*	string	Subscription id (sub_…)
at_period_end*	boolean	true = stop after the current period
idempotency_key*	string	Stable key for this business action (e.g. order-1042). Reuse the SAME key when retrying; a new key creates a new operation.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id",
    "at_period_end",
    "idempotency_key"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 3,
      "description": "Subscription id (sub_…)"
    },
    "at_period_end": {
      "type": "boolean",
      "description": "true = stop after the current period"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[\\x21-\\x7e]+$",
      "maxLength": 255,
      "minLength": 1,
      "description": "Stable key for this business action (e.g. order-1042). Reuse the SAME key when retrying; a new key creates a new operation."
    }
  }
}

xaalis_create_agent_wallet

Sandbox: create a spending wallet for an AI agent, with a per-payout cap and the only phone numbers it may pay. Fund it, then issue its ak_test_ key. In production a human sets up agent wallets.

Argument	Type	Description
name*	string
provider*	string
idempotency_key*	string	Stable key for this business action (e.g. order-1042). Reuse the SAME key when retrying; a new key creates a new operation.
max_daily_amount	integer	Optional cap on the wallet's payouts per day (Dakar time), in whole XOF (F CFA). Integer, no decimals: 5000 = 5 000 F CFA.
max_payout_amount*	integer	Largest single payout, in whole XOF (F CFA). Integer, no decimals: 5000 = 5 000 F CFA.
approval_max_amount	integer	With approval_above_limit: hard ceiling, at least max_payout_amount; nothing above it can be approved, in whole XOF (F CFA). Integer, no decimals: 5000 = 5 000 F CFA.
approval_above_limit	boolean	Sandbox: a payout above the caps waits for the owner's approval instead of failing

xaalis_create_payment

Create a payment and get a hosted checkout_url to send to the customer (Wave or Orange Money). The payment is NOT paid until its status is 'succeeded' — check with xaalis_get_payment or a signed webhook, never the customer's redirect.

Argument	Type	Description
amount*	integer	Amount the customer pays, in whole XOF (F CFA). Integer, no decimals: 5000 = 5 000 F CFA.
metadata	object	Your own string key/values
provider	string	Skip the method picker and start this provider directly
cancel_url	string
description	string	Shown to the customer
success_url	string
customer_name	string
customer_phone	string	Senegal mobile number, e.g. +221771234567
idempotency_key*	string	Stable key for this business action (e.g. order-1042). Reuse the SAME key when retrying; a new key creates a new operation.

xaalis_create_payout

Sandbox only with a merchant key: send money from the merchant balance to a Wave or Orange Money number. In production, agents pay out only through an agent wallet key (ak_) with limits set by a human.

destructive

Argument	Type	Description
amount*	integer	Amount the recipient receives, in whole XOF (F CFA). Integer, no decimals: 5000 = 5 000 F CFA.
provider*	string
recipient_name	string
idempotency_key*	string	Stable key for this business action (e.g. order-1042). Reuse the SAME key when retrying; a new key creates a new operation.
recipient_phone*	string	Senegal mobile number, e.g. +221771234567
client_reference	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "amount",
    "provider",
    "recipient_phone",
    "idempotency_key"
  ],
  "properties": {
    "amount": {
      "type": "integer",
      "maximum": 100000000,
      "description": "Amount the recipient receives, in whole XOF (F CFA). Integer, no decimals: 5000 = 5 000 F CFA.",
      "exclusiveMinimum": 0
    },
    "provider": {
      "enum": [
        "wave",
        "orange_money"
      ],
      "type": "string"
    },
    "recipient_name": {
      "type": "string",
      "maxLength": 100
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[\\x21-\\x7e]+$",
      "maxLength": 255,
      "minLength": 1,
      "description": "Stable key for this business action (e.g. order-1042). Reuse the SAME key when retrying; a new key creates a new operation."
    },
    "recipient_phone": {
      "type": "string",
      "pattern": "^\\+2217[0-9]{8}$",
      "description": "Senegal mobile number, e.g. +221771234567"
    },
    "client_reference": {
      "type": "string",
      "maxLength": 100
    }
  }
}

xaalis_create_subscription

Bill a customer every day/week/month/year. Invoice 0 is issued at once: send its hosted_invoice_url (in latest_invoice) to the customer. Set billing_cycles (2–24) for an instalment plan that ends by itself.

Argument	Type	Description
amount*	integer	Amount per period, whole XOF (min 100)
interval*	string
description	string
customer_name*	string
billing_cycles	integer	Instalment plan: number of payments; omit for an open-ended subscription
customer_email	string
customer_phone*	string	Senegal mobile number, e.g. +221771234567
days_until_due	integer
interval_count	integer
idempotency_key

xaalis_disable_agent_wallet

Stop an agent wallet: its keys can no longer start payouts. Payouts already accepted finish normally. Safe to repeat.

destructive

Argument	Type	Description
wallet_id*	string	Agent wallet id (aw_…)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "wallet_id"
  ],
  "properties": {
    "wallet_id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 3,
      "description": "Agent wallet id (aw_…)"
    }
  }
}

xaalis_fund_agent_wallet

Sandbox: move money from the merchant balance into an agent wallet. The wallet's balance is the agent's total spend limit.

Argument	Type	Description
amount*	integer	Amount to move, in whole XOF (F CFA). Integer, no decimals: 5000 = 5 000 F CFA.
wallet_id*	string	Agent wallet id (aw_…)
idempotency_key*	string	Stable key for this business action (e.g. order-1042). Reuse the SAME key when retrying; a new key creates a new operation.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "wallet_id",
    "amount",
    "idempotency_key"
  ],
  "properties": {
    "amount": {
      "type": "integer",
      "maximum": 100000000,
      "description": "Amount to move, in whole XOF (F CFA). Integer, no decimals: 5000 = 5 000 F CFA.",
      "exclusiveMinimum": 0
    },
    "wallet_id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 3,
      "description": "Agent wallet id (aw_…)"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[\\x21-\\x7e]+$",
      "maxLength": 255,
      "minLength": 1,
      "description": "Stable key for this business action (e.g. order-1042). Reuse the SAME key when retrying; a new key creates a new operation."
    }
  }
}

xaalis_get_agent_wallet

Read an agent wallet's policy and balance.

read-only

Argument	Type	Description
wallet_id*	string	Agent wallet id (aw_…)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "wallet_id"
  ],
  "properties": {
    "wallet_id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 3,
      "description": "Agent wallet id (aw_…)"
    }
  }
}

xaalis_get_balance

The merchant's available balance (withdrawable) and money reserved for payouts in flight, in XOF.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

xaalis_get_invoice

Read a subscription invoice: status, amount, due date, and hosted_invoice_url (the stable link to send the customer).

read-only

Argument	Type	Description
id*	string	Invoice id (inv_…)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 3,
      "description": "Invoice id (inv_…)"
    }
  }
}

xaalis_get_payment

Read a payment's current status, amount, fee and checkout link. 'succeeded' is the only proof the customer paid.

read-only

Argument	Type	Description
id*	string	Payment id (pay_…)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 3,
      "description": "Payment id (pay_…)"
    }
  }
}

xaalis_get_payout

Read a payout's status (pending, processing, succeeded, failed).

read-only

Argument	Type	Description
id*	string	Payout id (po_…)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 3,
      "description": "Payout id (po_…)"
    }
  }
}

xaalis_get_subscription

Read a subscription: status, cycles paid, latest invoice.

read-only

Argument	Type	Description
id*	string	Subscription id (sub_…)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 3,
      "description": "Subscription id (sub_…)"
    }
  }
}

xaalis_issue_agent_key

Sandbox: issue the ak_test_ key an agent uses to pay out from this wallet. The secret is shown ONCE — store it in a secret store or env var right away. Retrying with the same idempotency_key never shows it again.

Argument	Type	Description
wallet_id*	string	Agent wallet id (aw_…)
idempotency_key*	string	Stable key for this business action (e.g. order-1042). Reuse the SAME key when retrying; a new key creates a new operation.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "wallet_id",
    "idempotency_key"
  ],
  "properties": {
    "wallet_id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 3,
      "description": "Agent wallet id (aw_…)"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[\\x21-\\x7e]+$",
      "maxLength": 255,
      "minLength": 1,
      "description": "Stable key for this business action (e.g. order-1042). Reuse the SAME key when retrying; a new key creates a new operation."
    }
  }
}

xaalis_list_agent_wallets

List the merchant's agent wallets and their policies.

read-only

Argument	Type	Description
limit	integer	Page size, default 10
starting_after	string	Cursor: the last id of the previous page

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, default 10"
    },
    "starting_after": {
      "type": "string",
      "description": "Cursor: the last id of the previous page"
    }
  }
}

xaalis_list_invoices

List invoices, optionally for one subscription or by status.

read-only

Argument	Type	Description
limit	integer	Page size, default 10
status	string
subscription	string
starting_after	string	Cursor: the last id of the previous page

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, default 10"
    },
    "status": {
      "enum": [
        "open",
        "paid",
        "void",
        "uncollectible"
      ],
      "type": "string"
    },
    "subscription": {
      "type": "string"
    },
    "starting_after": {
      "type": "string",
      "description": "Cursor: the last id of the previous page"
    }
  }
}

xaalis_list_payments

List payments, newest first, optionally filtered by status.

read-only

Argument	Type	Description
limit	integer	Page size, default 10
status	string
starting_after	string	Cursor: the last id of the previous page

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, default 10"
    },
    "status": {
      "enum": [
        "requires_payment_method",
        "processing",
        "succeeded",
        "failed",
        "expired",
        "refunded"
      ],
      "type": "string"
    },
    "starting_after": {
      "type": "string",
      "description": "Cursor: the last id of the previous page"
    }
  }
}

xaalis_list_payouts

List the merchant's payouts, newest first, with their status and recipient.

read-only

Argument	Type	Description
limit	integer	Page size, default 10
starting_after	string	Cursor: the last id of the previous page

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, default 10"
    },
    "starting_after": {
      "type": "string",
      "description": "Cursor: the last id of the previous page"
    }
  }
}

xaalis_list_refunds

Read the refund of a payment, if any (a list of zero or one). Use it to check an uncertain refund instead of retrying.

read-only

Argument	Type	Description
payment_id*	string	Payment id (pay_…)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "payment_id"
  ],
  "properties": {
    "payment_id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 3,
      "description": "Payment id (pay_…)"
    }
  }
}

xaalis_list_subscriptions

List subscriptions, newest first, optionally by status.

read-only

Argument	Type	Description
limit	integer	Page size, default 10
status	string
starting_after	string	Cursor: the last id of the previous page

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, default 10"
    },
    "status": {
      "enum": [
        "active",
        "past_due",
        "canceled",
        "completed"
      ],
      "type": "string"
    },
    "starting_after": {
      "type": "string",
      "description": "Cursor: the last id of the previous page"
    }
  }
}

xaalis_list_webhook_deliveries

Recent webhooks Xaalis sent to the merchant's endpoint, with status, attempts and the last error — use it to debug a webhook integration.

read-only

Argument	Type	Description
limit	integer	Page size, default 10

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size, default 10"
    }
  }
}

xaalis_reclaim_agent_wallet

Sandbox: move unreserved money from an agent wallet back to the merchant balance.

Argument	Type	Description
amount*	integer	Amount to move back, in whole XOF (F CFA). Integer, no decimals: 5000 = 5 000 F CFA.
wallet_id*	string	Agent wallet id (aw_…)
idempotency_key*	string	Stable key for this business action (e.g. order-1042). Reuse the SAME key when retrying; a new key creates a new operation.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "wallet_id",
    "amount",
    "idempotency_key"
  ],
  "properties": {
    "amount": {
      "type": "integer",
      "maximum": 100000000,
      "description": "Amount to move back, in whole XOF (F CFA). Integer, no decimals: 5000 = 5 000 F CFA.",
      "exclusiveMinimum": 0
    },
    "wallet_id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 3,
      "description": "Agent wallet id (aw_…)"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[\\x21-\\x7e]+$",
      "maxLength": 255,
      "minLength": 1,
      "description": "Stable key for this business action (e.g. order-1042). Reuse the SAME key when retrying; a new key creates a new operation."
    }
  }
}

xaalis_refund_payment

Send the FULL amount of a succeeded Wave payment back to the customer (no partial refunds). The merchant's available balance must cover it. One refund per payment; the same idempotency_key returns the same refund.

destructive

Argument	Type	Description
payment_id*	string	Payment id (pay_…)
idempotency_key*	string	Stable key for this business action (e.g. order-1042). Reuse the SAME key when retrying; a new key creates a new operation.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "payment_id",
    "idempotency_key"
  ],
  "properties": {
    "payment_id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 3,
      "description": "Payment id (pay_…)"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[\\x21-\\x7e]+$",
      "maxLength": 255,
      "minLength": 1,
      "description": "Stable key for this business action (e.g. order-1042). Reuse the SAME key when retrying; a new key creates a new operation."
    }
  }
}

xaalis_sandbox_signup

Create a Xaalis SANDBOX merchant account and get its test secret key (sk_test_…) and webhook secret, with no human step. Sandbox only: no real money, simulated wallets. Going live later needs a human (KYC and approval). Store the returned secrets in environment variables, never in code.

Argument	Type	Description
email*	string	Contact email for the account
webhook_url	string	HTTPS endpoint that will receive signed webhooks (optional, can be set later)
business_name*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "email",
    "business_name"
  ],
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "maxLength": 200,
      "description": "Contact email for the account"
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "description": "HTTPS endpoint that will receive signed webhooks (optional, can be set later)"
    },
    "business_name": {
      "type": "string",
      "maxLength": 100,
      "minLength": 2
    }
  }
}

xaalis_search_docs

Search the official Xaalis documentation (payments, webhooks, payouts, refunds, subscriptions, SDKs, errors, go-live). Use it before guessing how an endpoint behaves.

read-only

Argument	Type	Description
limit	integer
query*	string	What you want to know, e.g. 'verify webhook signature node'

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 8,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 2,
      "description": "What you want to know, e.g. 'verify webhook signature node'"
    }
  }
}

xaalis_simulate_payment

Sandbox only: make a test payment succeed or fail as if the customer had paid (or declined) in their wallet. Triggers the same webhooks as a real payment.

Argument	Type	Description
id*	string	Payment id (pay_…)
outcome*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id",
    "outcome"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 3,
      "description": "Payment id (pay_…)"
    },
    "outcome": {
      "enum": [
        "succeeded",
        "failed"
      ],
      "type": "string"
    }
  }
}

xaalis_whoami

Start here. Shows which Xaalis key is connected (none, merchant test/live, agent wallet), its mode, the account or wallet it belongs to, and which tools it unlocks.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name",
    "provider",
    "max_payout_amount",
    "allowed_recipient_phones",
    "idempotency_key"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 120,
      "minLength": 2
    },
    "provider": {
      "enum": [
        "wave",
        "orange_money"
      ],
      "type": "string"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[\\x21-\\x7e]+$",
      "maxLength": 255,
      "minLength": 1,
      "description": "Stable key for this business action (e.g. order-1042). Reuse the SAME key when retrying; a new key creates a new operation."
    },
    "max_daily_amount": {
      "type": "integer",
      "maximum": 100000000,
      "description": "Optional cap on the wallet's payouts per day (Dakar time), in whole XOF (F CFA). Integer, no decimals: 5000 = 5 000 F CFA.",
      "exclusiveMinimum": 0
    },
    "max_payout_amount": {
      "type": "integer",
      "maximum": 100000000,
      "description": "Largest single payout, in whole XOF (F CFA). Integer, no decimals: 5000 = 5 000 F CFA.",
      "exclusiveMinimum": 0
    },
    "approval_max_amount": {
      "type": "integer",
      "maximum": 100000000,
      "description": "With approval_above_limit: hard ceiling, at least max_payout_amount; nothing above it can be approved, in whole XOF (F CFA). Integer, no decimals: 5000 = 5 000 F CFA.",
      "exclusiveMinimum": 0
    },
    "approval_above_limit": {
      "type": "boolean",
      "description": "Sandbox: a payout above the caps waits for the owner's approval instead of failing"
    },
    "allowed_recipient_phones": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^\\+2217[0-9]{8}$",
        "description": "Senegal mobile number, e.g. +221771234567"
      },
      "maxItems": 20,
      "minItems": 1,
      "description": "1 to 20 distinct numbers this wallet may pay"
    }
  }
}

Xaalis

Try it

xaalis_advance_subscription

Xaalis

Try it

xaalis_advance_subscription

Install

Tools (28)

Security checkA100/100