Back to the catalog

Airwallex AgentOS

Bring Airwallex's global financial infrastructure to Claude. Orchestrate actions across your account in plain language, e.g., set up invoice

Open source Repository Open in the app JSON README (API)

About

Bring Airwallex's global financial infrastructure to Claude. Orchestrate actions across your account in plain language, e.g., set up invoices from a PO, onboard suppliers from invoices, and check current cash position across currencies. AgentOS bundles pre-built finance Skills with MCP servers. A public CLI connects your agent to Airwallex's capabilities.

Details

Kind
Plugins
Topic
Finance & crypto
Publisher
airwallex
Origin
marketplace
Category
ferramentas
Stars
5
Forks
2
Last push
2026-08-24T13:29:10Z
Repository state
ativo
License
Apache-2.0
Added
2026-08-30 01:48:58
Updated
2026-09-12 04:04:13
Origin id
airwallex/airwallex-marketplace/airwallex-agentos

README

# Airwallex AI

Agent skills for integrating Airwallex with LLMs and agent frameworks.

## Plugins

| Plugin | Surfaces | Archetype | Description |
| --- | --- | --- | --- |
| [airwallex-agentos](./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](./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 AgentOS** 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-agentos --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](LICENSE).

More