airwallex-agentos plugin (Claude Code / Cursor / Codex)

Teaches Claude, Cursor, and Codex how to use Airwallex across Billing, Payouts, Issuing, and Treasury, through either the airwallex CLI or an Airwallex MCP server.

The same skills work on every supported surface. Each SKILL.md is surface-neutral: the workflow logic is shared, and the agent picks up the surface-specific details (command names, tool names, auth, pagination) from awx-best-practices/references/surface-quickstart.md and from the connected toolchain itself.

Skills

Skill	Category	Description
contract-to-billing	Billing	Extract billing details from POs/contracts/quotes, match existing resources, and create invoices and/or subscriptions
beneficiary-creation	Payouts	Extract bank details from supplier documents, validate per-country schemas, and create beneficiaries
card-provisioning	Issuing	Create cardholders and issue virtual or physical corporate cards with spend limits, and manage card spending
manage-cashflow	Treasury	Aggregate multi-currency balances, receivables, obligations, FX exposure, and indicative rates (conversion execution via Airwallex Dashboard)
awx-best-practices	Fallback	Ad-hoc operations, troubleshooting, and domains not covered by a workflow skill above

Skill file structure

Each workflow skill is self-contained in a single SKILL.md (workflow, examples, gotchas). Larger skills carry a references/ folder with templates and pitfall notes that the agent loads only when it needs them:

skills/awx-best-practices/
├── SKILL.md                       # Domain routing, auth rules, refusal templates
└── references/
    ├── api_traps.md               # Common API pitfalls and workarounds
    └── surface-quickstart.md      # CLI- and MCP-specific operating rules

Plugin structure

airwallex-agentos/
├── .claude-plugin/plugin.json
├── .codex-plugin/plugin.json
├── .cursor-plugin/plugin.json
├── .cursor-mcp.json
├── .mcp.json
├── assets/
│   ├── icon.svg
│   └── logo.svg
├── references/
│   └── feedback.md
├── README.md
└── skills/
    ├── contract-to-billing/
    │   └── SKILL.md
    ├── beneficiary-creation/
    │   └── SKILL.md
    ├── card-provisioning/
    │   ├── SKILL.md
    │   └── references/
    │       └── card-templates.md
    ├── manage-cashflow/
    │   ├── SKILL.md
    │   └── references/
    │       └── response-templates.md
    └── awx-best-practices/
        ├── SKILL.md
        └── references/
            ├── api_traps.md
            └── surface-quickstart.md

Prerequisites

You need at least one of the following toolchains available. The skills detect which one the agent is using and act accordingly.

CLI: airwallex CLI installed and authenticated (airwallex auth login).
MCP: An Airwallex MCP server connected to your Claude Code, Cursor, or Codex client. Configure the MCP server entry per your host's MCP setup docs.

Airwallex AgentOS