{"_id":"@codespar/mcp-airwallex","_rev":"5-1c7b0d5c00c94e51d99745f261da41da","name":"@codespar/mcp-airwallex","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-airwallex","version":"0.1.0","keywords":["mcp","airwallex","payments","payouts","fx","cross-border","embedded-finance","global-accounts","latam"],"license":"MIT","_id":"@codespar/mcp-airwallex@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-airwallex":"dist/index.js"},"dist":{"shasum":"99f4d7f08c2c7a069c53df72edf555acea36674b","tarball":"https://registry.npmjs.org/@codespar/mcp-airwallex/-/mcp-airwallex-0.1.0.tgz","fileCount":6,"integrity":"sha512-npvfTwd7+Gibaq6rphIoX8zpnovlkZAZsmw/bfPhpVDvQGnCNNBvi9ME6ln+iqOb5BVfJCJIJh2WTxZB8y+Eaw==","signatures":[{"sig":"MEYCIQCVyb7OLml5XXYRDcbuRucjqbw7ZHBggCxAeZB29YAr1wIhAIEdNtFO6944r3pfMtHDO8VIl7vxXXXswuosAH6MVWVC","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":49856},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"c00634d3cb84e72668261708b2a55e90bf9ae780","mcpName":"io.github.codespar/mcp-airwallex","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Airwallex — embedded finance for cross-border collection and payouts. LatAm sellers collect USD/EUR abroad and settle locally.","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-airwallex_0.1.0_1776992563674_0.16830003284070405","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@codespar/mcp-airwallex","version":"0.2.0","keywords":["mcp","airwallex","payments","payouts","fx","cross-border","embedded-finance","global-accounts","latam"],"license":"MIT","_id":"@codespar/mcp-airwallex@0.2.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-airwallex":"dist/index.js"},"dist":{"shasum":"ba10b189fc86a810761ae94c213396b782c1a7b9","tarball":"https://registry.npmjs.org/@codespar/mcp-airwallex/-/mcp-airwallex-0.2.0.tgz","fileCount":6,"integrity":"sha512-FNYX7PqZ49ftEuM6HK0Xa8pKf6H5Lt/+BYhLsf8w4OOM9aMSbI+fM2qWlfjBDmNEPl5IEj0p4B1P2PIwHv0kIg==","signatures":[{"sig":"MEQCID+M7InSiJDnCD5i2w4SMY2cABERH6YgafXtQlZ3+u0tAiBSiv299i6DKoVYpRwXPhDl/LxKrsxud1CO6KZV/7K/Kw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":71387},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"aa155cfd90298f7233644389f945286db9d20fe4","mcpName":"io.github.codespar/mcp-airwallex","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Airwallex — embedded finance for cross-border collection and payouts. LatAm sellers collect USD/EUR abroad and settle locally.","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-airwallex_0.2.0_1777065406138_0.4418882141942144","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@codespar/mcp-airwallex","version":"0.2.1","keywords":["mcp","airwallex","payments","payouts","fx","cross-border","embedded-finance","global-accounts","latam"],"license":"MIT","_id":"@codespar/mcp-airwallex@0.2.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-airwallex":"dist/index.js"},"dist":{"shasum":"3e9a63bef4d7b09e586fd0c95d659d6f56ba55b5","tarball":"https://registry.npmjs.org/@codespar/mcp-airwallex/-/mcp-airwallex-0.2.1.tgz","fileCount":6,"integrity":"sha512-vxNzq4Ke3yj/9HmDeTKhp7uQT2iAPKj2PFJi/ERefbk81VcJJt3PxrQsDAK4afOeMNZ18DR/hNslFB48MZ4VsA==","signatures":[{"sig":"MEQCIHeB8A2hqar+QSmHh2cy2cZUqbLUX3+cD9yTVOcQgo44AiAr+orzHJKFksKwIC5fW48VWtuvDbTtMKSy5lgdd9r6rQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":72190},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-airwallex","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Airwallex — embedded finance for cross-border collection and payouts. LatAm sellers collect USD/EUR abroad and settle locally.","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-airwallex_0.2.1_1777123156202_0.7563088656400199","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@codespar/mcp-airwallex","version":"0.2.2","description":"MCP server for Airwallex — embedded finance for cross-border collection and payouts. LatAm sellers collect USD/EUR abroad and settle locally.","type":"module","main":"./dist/index.js","bin":{"mcp-airwallex":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","airwallex","payments","payouts","fx","cross-border","embedded-finance","global-accounts","latam"],"mcpName":"io.github.codespar/mcp-airwallex","_id":"@codespar/mcp-airwallex@0.2.2","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-6Du3G8mAfppT1c//MxZTu0YSe8AkckazJX0Tx7TPYmZehG1Vd2BM4yKYFGy582RwCPXoRPkL6zyFAjaioIt7Og==","shasum":"51f89e68f83a159465f89aabf4dfed5496685198","tarball":"https://registry.npmjs.org/@codespar/mcp-airwallex/-/mcp-airwallex-0.2.2.tgz","fileCount":6,"unpackedSize":73650,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCvkBA+ipdc6BlPONjUBYKCXXT3HOECVT6xq/aWt3/BsgIhAIHS2ZJe24wHD96PHehFIXlP4dzWEr43IonShDpZxe4Z"}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-airwallex_0.2.2_1782153767822_0.947044863713514"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-24T01:02:43.572Z","modified":"2026-06-22T18:42:48.112Z","0.1.0":"2026-04-24T01:02:43.820Z","0.2.0":"2026-04-24T21:16:46.305Z","0.2.1":"2026-04-25T13:19:16.489Z","0.2.2":"2026-06-22T18:42:47.960Z"},"license":"MIT","keywords":["mcp","airwallex","payments","payouts","fx","cross-border","embedded-finance","global-accounts","latam"],"description":"MCP server for Airwallex — embedded finance for cross-border collection and payouts. LatAm sellers collect USD/EUR abroad and settle locally.","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-airwallex\n\nMCP server for [Airwallex](https://www.airwallex.com) — embedded finance for cross-border collection and payouts.\n\nEBANX lets global platforms collect FROM LatAm and settle to USD. Airwallex is the inverse: LatAm sellers collect FROM abroad (USD, EUR, GBP) into global accounts, convert FX, and pay beneficiaries out across 150+ countries. Together the two servers bracket the cross-border flow both ways.\n\n## Tools (20)\n\n| Tool | Purpose |\n|---|---|\n| `create_payment_intent` | Create an Airwallex payment intent (pay-in). |\n| `confirm_payment_intent` | Confirm a previously-created payment intent with a payment method. |\n| `retrieve_payment_intent` | Retrieve a payment intent by id. |\n| `cancel_payment_intent` | Cancel a payment intent that has not yet been captured. |\n| `capture_payment_intent` | Capture a previously-authorized payment intent (two-step auth + capture flow). |\n| `list_payment_intents` | List payment intents with optional filters (status, merchant_order_id, date range). |\n| `create_refund` | Refund a captured payment intent (full or partial). |\n| `retrieve_refund` | Retrieve a refund by id. |\n| `create_customer` | Create an Airwallex customer for saved payment methods and recurring charges. |\n| `retrieve_customer` | Retrieve a customer by id. |\n| `update_customer` | Update fields on an existing customer (email, phone, address, metadata). |\n| `create_beneficiary` | Create a transfer beneficiary (recipient) with bank details. |\n| `retrieve_beneficiary` | Retrieve a beneficiary by id. |\n| `list_beneficiaries` | List beneficiaries. |\n| `create_transfer` | Send a cross-border transfer to a pre-created beneficiary. |\n| `retrieve_transfer` | Retrieve a transfer by id. |\n| `cancel_transfer` | Cancel a transfer that has not yet settled. |\n| `list_transfers` | List transfers with optional filters (status, date range). |\n| `create_conversion` | Execute an FX conversion between wallet currencies (e.g. |\n| `retrieve_balance` | Retrieve the current wallet balance for every currency the account holds. |\n\n## Install\n\n```bash\nnpm install @codespar/mcp-airwallex\n```\n\n## Environment\n\n```bash\nAIRWALLEX_CLIENT_ID=\"...\"   # x-client-id header on /authentication/login\nAIRWALLEX_API_KEY=\"...\"     # x-api-key header on /authentication/login (secret)\nAIRWALLEX_ENV=\"demo\"        # 'demo' (default) or 'production'\n```\n\nBase URLs:\n- `demo` → `https://api-demo.airwallex.com/api/v1`\n- `production` → `https://api.airwallex.com/api/v1`\n\n## Authentication\n\nToken flow. On first call the server POSTs to `/authentication/login` with headers `x-client-id` and `x-api-key` (no body). Airwallex returns `{ token, expires_at }` (JWT, ~30 min lifetime). The server caches the token in memory and refreshes it 60 seconds before expiry. Every subsequent call sends `Authorization: Bearer <token>`.\n\n## Idempotency\n\nEvery `create_*` tool takes a required `request_id` parameter. Airwallex uses this as the idempotency key. The server never auto-generates it — agents must pass a stable UUID per logical operation so retries are safe.\n\n## Run\n\n```bash\n# stdio (default — for Claude Desktop, Cursor, etc)\nnpx @codespar/mcp-airwallex\n\n# HTTP (for server-to-server testing)\nMCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-airwallex\n```\n\n## Positioning vs EBANX\n\n| Flow | Use |\n|------|-----|\n| Global platform collecting from LatAm buyers, settling to USD | [@codespar/mcp-ebanx](../ebanx) |\n| LatAm seller collecting from global buyers in USD/EUR/GBP, settling locally | `@codespar/mcp-airwallex` |\n\nPair both for bidirectional cross-border coverage.\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}