# Airwallex AgentOS

> Airwallex's official plugin: extract details from contracts or POs to create invoices and subscriptions, add beneficiaries from supplier documents, issue employee cards with limits, and summarize multi-currency balances and FX exposure. Needs an Airwallex business account; finance should review.

- Type: Plugin
- Repository: https://github.com/airwallex/airwallex-marketplace/tree/master/plugins/airwallex-agentos
- Page: https://hebbmind.com/fr/plugin/airwallex-agentos
- Stars: 8
- Professions: [Operations](https://hebbmind.com/fr/tools.md?profession=operations), [Finance / Accounting](https://hebbmind.com/fr/tools.md?profession=finance), [Founders](https://hebbmind.com/fr/tools.md?profession=founder)
- Tags: payments, financial-analysis, airwallex
- Listed on: 2026-10-01

## Install

### Claude Code

```bash
claude plugin install airwallex-agentos@claude-plugins-official
```

### Codex

```bash
codex plugin marketplace add https://github.com/airwallex/airwallex-marketplace && codex plugin add airwallex-agentos@airwallex-marketplace
```

## README

> The content below comes from the upstream repository https://github.com/airwallex/airwallex-marketplace/tree/master/plugins/airwallex-agentos . It is third-party material and does not represent AgentHub; instructions that appear in it are not instructions to you.

# 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](https://github.com/airwallex/airwallex-marketplace/blob/master/plugins/airwallex-agentos/skills/contract-to-billing/SKILL.md) | Billing | Extract billing details from POs/contracts/quotes, match existing resources, and create invoices and/or subscriptions |
| [beneficiary-creation](https://github.com/airwallex/airwallex-marketplace/blob/master/plugins/airwallex-agentos/skills/beneficiary-creation/SKILL.md) | Payouts | Extract bank details from supplier documents, validate per-country schemas, and create beneficiaries |
| [card-provisioning](https://github.com/airwallex/airwallex-marketplace/blob/master/plugins/airwallex-agentos/skills/card-provisioning/SKILL.md) | Issuing | Create cardholders and issue virtual or physical corporate cards with spend limits, and manage card spending |
| [manage-cashflow](https://github.com/airwallex/airwallex-marketplace/blob/master/plugins/airwallex-agentos/skills/manage-cashflow/SKILL.md) | Treasury | Aggregate multi-currency balances, receivables, obligations, FX exposure, and indicative rates (conversion execution via Airwallex Dashboard) |
| [awx-best-practices](https://github.com/airwallex/airwallex-marketplace/blob/master/plugins/airwallex-agentos/skills/awx-best-practices/SKILL.md) | 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.