Skip to content

ant-intl/antom-ai-tools

v0.1.0MIT

Portable Antom payment integration and reconciliation skills for AI agents.

Antom AI Tools

A one-stop repository for building AI-powered products with Antom payment integration. This repository provides shared Agent Skills, provider-specific editor plugins, and an Agent Plugins 1.0-compatible portable package with an optional Antom MCP server connection.

Available Skills

SkillDescription
antom-integrationIntegrate Antom payment products including One-time Payments, Tokenized Payment, and Subscription Payment.
antom-reconciliation-expertReconciliation Report Analysis Expert — Parses local Settlement Detail report files (CSV/XLSX) for settlement amount validation, fee analysis, and reconciliation knowledge Q&A.

Available Plugins

Provider-specific packages remain available for supported editors and agent platforms. The repository root is also an Agent Plugins 1.0-compatible portable package, allowing compatible clients to discover the shared Skills and Antom MCP configuration.

PlatformTypeNameSource
Agent Plugins 1.0-compatible clientsPortable Pluginantom-ai-toolsplugin.json · mcp.json · skills/
CursorPluginantom-integrationproviders/cursor/plugin
Claude CodePluginantom-integrationproviders/claude/plugin
CodexPluginantom-integrationproviders/codex/plugins/antom-integration
OpenClawSkillantom-reconciliation-expertskills/antom-reconciliation-expert

Portable Agent Plugin

The repository root follows the Agent Plugins 1.0 specification:

  • plugin.json identifies the portable plugin.
  • skills/ remains the source of truth for the bundled Agent Skills.
  • mcp.json declares the optional Antom MCP server connection.

Installation, permissions, and authentication are managed by each compatible client. Follow the instructions provided by your client to load this repository root as an Agent Plugin.

Antom MCP Server

The portable plugin declares the hosted Antom MCP server:

The MCP server complements the existing Skills and does not replace them. If the MCP connection is unavailable, compatible clients can continue loading the bundled Skills.

Access: The Antom MCP server is currently available through a controlled allowlist rollout. See the Antom MCP documentation for access application instructions. After approval, authentication is handled through the client-managed OAuth flow; do not add credentials to mcp.json.

antom-integration

What Problem Does It Solve

Antom encapsulates core payment capabilities into standardized Skill components that are fully readable by AI. Developers can quickly integrate payments in Vibe Coding mode without dealing with complex underlying logic — simply describe your needs in natural language.

This Skill helps AI quickly load the Antom knowledge base, answer Antom integration questions, and generate integration code, significantly reducing the learning curve and development effort for payment integration.

Install

Cursor

Submit / install via the Cursor marketplace, or for local development:

cp -R providers/cursor/plugin ~/.cursor/plugins/local/antom-integration
# then restart Cursor (>= 2.6)

Marketplace entry: .cursor-plugin/marketplace.json

Claude Code

/plugin marketplace add ant-intl/antom-ai-tools
/plugin install antom-integration@antom

For local development, point the marketplace at the working copy:

/plugin marketplace add /absolute/path/to/antom-ai-tools

Validate locally:

claude plugin validate .

Marketplace entry: .claude-plugin/marketplace.json

Codex

Marketplace entry: .codex-plugin/marketplace.json (legacy importer reads .agents/plugins/marketplace.json).

Plugin manifest: providers/codex/plugins/antom-integration/.codex-plugin/plugin.json

Test Assets

When you ask AI for a test card or to test a payment, it pulls the latest sandbox test data straight from the official Antom docs (never hardcoded):

SourceUse
docs.antom.com/ac/ref/card.mdSandbox test cards (fetched live): success / failure / 3DS / risk-control / invalid-input scenarios
docs.antom.com/ac/ref/wallet.md · testwallet.mdHow to test wallet / BNPL / online-banking (APM) payments: test wallet app + QR / login flow
docs.antom.com/ac/cashierpay/testcases.mdGo-live validation checklist (production test cases)

In Claude Code, the plugin also exposes slash commands:

/test-cards
/test-wallet

Example Prompts

Help me choose the right Antom payment integration.
Generate Antom checkout integration code.
Review my Antom payment flow for security issues.

Important Notes

  1. When describing your requirements to AI, be specific about the payment scenario (e.g., One-time Payment, Redirect to CKP Payment) to avoid ambiguity and potential misinterpretation.
  2. Always review the integration code generated by AI and verify the logic yourself before deployment.
  3. The Skill is updated in sync with Antom product iterations. It is recommended to periodically re-run the installation command to get the latest version.

antom-reconciliation-expert

What Problem Does It Solve

Antom delivers Settlement Detail reports to merchants, but verifying settlement amounts, understanding fee breakdowns, and attributing discrepancies manually is tedious and error-prone — especially when dealing with hundreds of rows across multiple fee types and currencies.

This Skill turns AI into a reconciliation expert. Simply provide your local Settlement Detail report file or ask a question in natural language, and AI will parse the data, validate every settlement formula, break down all fee components, and explain reconciliation rules — significantly reducing the time and effort needed for settlement verification.

Install

OpenClaw

Manually copy the skill into your OpenClaw skills directory:

cp -R skills/antom-reconciliation-expert ~/.openclaw/skills/antom-reconciliation-expert

Verify installation:

openclaw skills list

Example Prompts

Help me analyze SETTLEMENT_DETAIL_202604271985548486_20260428.xlsx
What is interchangeFee and how is it calculated?
Validate the settlement amounts in my report and show me any discrepancies.

Important Notes

  1. When providing a report file, make sure it is a Settlement Detail report (filename must contain both SETTLEMENT and DETAIL). Transaction Detail and Settlement Summary reports are not supported.
  2. Only .csv and .xlsx file formats are accepted. Other formats (.xls, .pdf, .txt, etc.) will be rejected.
  3. Fee amounts (such as interchangeFee, schemeFee) are displayed as-is from the report. The Skill does not perform reverse rate calculation on these fees.
  4. The Skill is updated in sync with Antom product iterations. It is recommended to periodically re-run the installation command to get the latest version.

Repository Layout

plugin.json                              # Agent Plugins 1.0 manifest
mcp.json                                 # hosted Antom MCP connection
.cursor-plugin/marketplace.json
.claude-plugin/marketplace.json
.codex-plugin/marketplace.json
.agents/plugins/marketplace.json
skills/antom-integration/SKILL.md          # shared source of truth
skills/antom-reconciliation-expert/        # reconciliation expert skill + scripts
providers/
  cursor/plugin/        # Cursor adapter
  claude/plugin/        # Claude Code adapter
  codex/plugins/        # Codex adapter
LICENSE

Each provider package is self-contained and ships its own copy of the skill so editors can load it independently. The single source of truth is skills/; provider copies are mirrored from it via the sync script below.

Sync Skills Across Providers

When you edit skills/<name>/..., mirror the change into every provider package with:

npm run sync-skills
# or
node scripts/sync-skills.mjs

The script copies every file under skills/<name>/ into:

  • providers/cursor/plugin/skills/<name>/
  • providers/claude/plugin/skills/<name>/
  • providers/codex/plugins/<name>/skills/<name>/

Run it before committing skill changes so all editors stay in lockstep.

On GitHub, the sync-skills workflow watches skills/** and scripts/sync-skills.mjs. When main receives changes there, it runs npm run sync-skills and opens a chore/sync-skills PR with the mirrored provider copies — so you only need to edit the source-of-truth and merge the auto-generated PR.

Community & Support

If Antom AI Tools helps you, consider starring the repository to follow future updates.

Contact

Antom Technical Service — TechnicalService@antom.com

License

MIT — see LICENSE.