A Model Context Protocol (MCP) compatible server that integrates Ant International's Antom payment APIs, enabling AI assistants to handle payment and refund operations seamlessly.
The Antom MCP Server wraps Ant International's Antom payment APIs into standardized MCP tools, allowing AI assistants to securely process payment-related operations during conversations. With this server, you can create payment sessions, query transaction status, handle refunds, and more directly through AI interactions.
create_payment_session
): Generate payment sessions for client-side SDK integrationquery_payment_detail
): Retrieve transaction status and information for submitted payment requestscancel_payment
): Cancel payments when results are not returned within expected timeframescreate_refund
): Initiate full or partial refunds against successful paymentsquery_refund_detail
): Check refund status for previously submitted refund requestsBefore using the Antom MCP Server, ensure you have:
git clone https://github.com/alipay/global-antom-mcp.git cd global-antom-mcp uv install2. MCP Client Configuration
Add the following configuration to your MCP client:
{ "mcpServers": { "antom-mcp-server": { "command": "uvx", "args": ["ant-intl-antom-mcp"], "env": { "GATEWAY_URL": "https://open-sea-global.alipay.com", "CLIENT_ID": "your_client_id_here", "MERCHANT_PRIVATE_KEY": "your_merchant_private_key_here", "ALIPAY_PUBLIC_KEY": "your_alipay_public_key_here", "PAYMENT_REDIRECT_URL": "/", "PAYMENT_NOTIFY_URL": "https://your-domain.com/payment/notify" } } } }Variable Required Description
GATEWAY_URL
❌ Antom API gateway URL (defaults to https://open-sea-global.alipay.com) CLIENT_ID
✅ Merchant client ID for identity verification MERCHANT_PRIVATE_KEY
✅ Merchant RSA private key for request signing ALIPAY_PUBLIC_KEY
✅ Alipay RSA public key for response verification PAYMENT_REDIRECT_URL
❌ The user is redirected to after the payment is completed PAYMENT_NOTIFY_URL
❌ Payment result notification callback URL
Here's how you can integrate the Antom MCP Server with your AI agent (using QwenAgent as an example):
import os from qwen_agent.agents import Assistant # Configure the MCP server as a tool tools = [{ "mcpServers": { "antom-mcp-server": { "command": "uvx", "args": ["ant-intl-antom-mcp"], "env": { "CLIENT_ID": os.getenv('CLIENT_ID'), "MERCHANT_PRIVATE_KEY": os.getenv('MERCHANT_PRIVATE_KEY'), "ALIPAY_PUBLIC_KEY": os.getenv('ALIPAY_PUBLIC_KEY'), "GATEWAY_URL": "https://open-sea-global.alipay.com", "PAYMENT_REDIRECT_URL": "/", "PAYMENT_NOTIFY_URL": "https://your-domain.com/notify" } } } }] # Create your AI assistant with payment capabilities bot = Assistant( llm={'model': 'qwen-max', 'api_key': 'your-api-key'}, function_list=tools, system_message="You are a helpful assistant with payment processing capabilities." )
See CHANGELOG.md for a detailed history of changes.
This project is licensed under the MIT License.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4