# Airwallex AI
Agent skills for integrating Airwallex with LLMs and agent frameworks.
## Plugins
| Plugin | Surfaces | Archetype | Description |
| --- | --- | --- | --- |
| [airwallex-agentos](https://github.com/airwallex/airwallex-marketplace/blob/HEAD/plugins/airwallex-agentos) | CLI + MCP | Workflow / Reference | Agent skills for Billing, Payouts, Issuing, and Treasury. Works with the `airwallex` CLI or an Airwallex MCP server. |
| [airwallex-dev](https://github.com/airwallex/airwallex-marketplace/blob/HEAD/plugins/airwallex-dev) | MCP | Integration | Developer-focused skills that generate production-ready code for Airwallex API integrations. |
### airwallex-agentos - Workflow & Reference Skills
| Skill | Category | Description |
| --- | --- | --- |
| contract-to-billing | Billing | Extract from POs/contracts/quotes → create invoices and/or subscriptions |
| beneficiary-creation | Payouts | Extract bank details from supplier docs → validate per-country → create beneficiaries |
| card-provisioning | Issuing | Create cardholders, issue virtual/physical cards with spend limits, manage spending |
| manage-cashflow | Treasury | Aggregate multi-currency balances, receivables, obligations, FX exposure, indicative rates |
| awx-best-practices | Fallback | Ad-hoc operations, troubleshooting, and domains not covered by a workflow skill above |
### airwallex-dev - Integration Skills
These skills work on the code in your project rather than driving conversations. Five generate integration code; `airwallex-ai-provider-card-mit` produces an implementation plan document instead.
Install with `claude plugin install airwallex-dev@airwallex-marketplace` or `codex plugin add airwallex-dev@airwallex-marketplace`, after adding the marketplace as shown under [Installation](#installation).
| Skill | Category | Description |
| --- | --- | --- |
| airwallex-hpp | Payments | Hosted Payment Page: redirect-based checkout hosted by Airwallex |
| airwallex-dropin | Payments | Drop-in Element: embedded UI supporting multiple payment methods |
| airwallex-split-card | Payments | Split Card Element: separate card number, expiry, and CVC inputs for full UI control |
| airwallex-billing-checkout | Billing | Billing Hosted Checkout for subscriptions, one-off payments, and card-saving (SETUP) |
| airwallex-kyc | Connected Accounts | Connected account KYC onboarding via embedded component or hosted link |
| airwallex-ai-provider-card-mit | Payments | Implementation plan for card-on-file MIT flows used by AI providers (top-ups, auto-recharge, subscriptions) |
### Connectors
Claude Code, Cursor, and Codex installations include the MCP connector automatically. If you install via `npx skills`, you will need to set up a connector separately. See the [Connectors](https://www.airwallex.com/docs/developer-tools/ai/agentos/connectors) page for options:
- **CLI:** `airwallex` CLI installed and authenticated.
- **MCP:** An Airwallex MCP server connected to your AI coding assistant.
## Installation
Pick the method that matches your editor or workflow. The two plugins install separately, so choose whichever you need.
### Claude Code
Add the marketplace, then install either plugin:
```sh
claude plugin marketplace add https://github.com/airwallex/airwallex-marketplace
claude plugin install airwallex-agentos@airwallex-marketplace
claude plugin install airwallex-dev@airwallex-marketplace
```
> **Skill namespacing:** Installed skills are prefixed by the plugin name. To invoke a skill, use the format `/airwallex-agentos:contract-to-billing` or `/airwallex-dev:airwallex-hpp`.
### Cursor
`airwallex-agentos` is listed in the [Cursor Marketplace](https://cursor.com/marketplace). Search for **Airwallex** in **Cursor Settings → Plugins** to install it.
`airwallex-dev` is not listed there yet, so add this marketplace by URL instead: in **Cursor Settings → Plugins**, click **Import** under **Team Marketplaces** and paste `https://github.com/airwallex/airwallex-marketplace`, then install `airwallex-dev`.
### Codex
Add the marketplace and install the plugin:
```sh
codex plugin marketplace add https://github.com/airwallex/airwallex-marketplace
codex plugin add airwallex-agentos@airwallex-marketplace
codex plugin add airwallex-dev@airwallex-marketplace
```
You can also browse and install from the Codex plugin directory (`/plugins` in the CLI). The Codex plugins use the same skills and MCP server configuration as the Claude Code and Cursor plugins.
### Grok
Add the marketplace, then install either plugin:
```sh
grok plugin marketplace add https://github.com/airwallex/airwallex-marketplace
grok plugin install airwallex --trust
grok plugin install airwallex-dev --trust
```
The Grok plugins use the same skills and MCP server configuration as the Claude Code, Cursor, and Codex plugins.
### npx (skills only)
Install the agent skills with a single command:
```sh
npx skills add airwallex/airwallex-marketplace
```
This installs the agent skills only and does **not** configure an Airwallex MCP server connection. If your workflow requires the MCP server, you will need to set it up separately in your client's MCP configuration. See [Connectors](#connectors) above.
---
> **Upgrading from 0.1.x?** Install `airwallex-agentos` to get the renamed plugin. The old `airwallex` entry becomes a tombstone with no skills or MCP servers — uninstalling it is recommended cleanup but not a prerequisite. Update any skill invocations from `/airwallex:…` to `/airwallex-agentos:…`.
After installing, make sure you have at least one of the prerequisite toolchains available (the `airwallex` CLI or an Airwallex MCP server). See [Connectors](#connectors) above.
## Important Notice
> **Beta Feature.** This plugin is provided on an "as-is" basis for use with
> Airwallex APIs (via the `airwallex` CLI or an MCP server). By using this
> plugin, you acknowledge that:
>
> - Actions taken via your Airwallex API keys, whether initiated by you
> directly or by an AI agent acting on your behalf, are governed by the
> [Airwallex Terms of Service](https://www.airwallex.com/terms) accepted
> during account creation and surface authentication (`airwallex auth login`
> for the CLI, OAuth authorization for the MCP server).
> - You are responsible for safeguarding your API keys and ensuring they are
> used only in accordance with your intended purpose.
> - This plugin does **not** provide financial, legal, or tax advice. AI agent
> outputs are probabilistic and should be reviewed by a qualified person
> before acting on them.
> - This plugin does **not** initiate money-out actions (transfers, FX
> conversions, or payouts) on your behalf. Where such capabilities exist in
> the underlying API, the skills are explicitly instructed not to execute
> them.
## License
Apache-2.0. See [LICENSE](https://github.com/airwallex/airwallex-marketplace/blob/HEAD/LICENSE).
