Alipay AI Pay MCP Server

An MCP (Model Context Protocol) server that exposes Alipay AI Pay capabilities to any MCP-compatible AI client.

Enables AI agents (Claude Desktop, Cursor, Claude Code, Windsurf, etc.) to:

• Discover available AI skills on the marketplace
• Get detailed skill info including pricing (with HTTP 402 payment flow)
• Get step-by-step Alipay payment integration guides
• Access merchant onboarding (签约/入驻) workflows

Supported Products

Product	Interface	Description
Pay-Per-Use (按量付费/402)	alipay.trade.pay	Per-API-call billing for AI skills & SaaS
Website Payment (网站支付)	alipay.trade.page.pay	Standard web payment (PC + mobile H5)
APP Payment (APP支付)	alipay.trade.app.pay	In-app payment for native iOS/Android

Note: This server does NOT support 当面付, 订单码支付, JSAPI支付, 预授权支付, or 商家扣款.

Tools

Tool	Description
discover_skills	List all available AI skills on the marketplace with pricing
get_skill_detail	Get full SKILL.md content for a specific skill (handles HTTP 402 payment flow)
get_alipay_integration_guide	Step-by-step integration guide for a chosen product + language
get_alipay_onboarding_guide	Merchant onboarding workflow and required documents

Prompts

Prompt	Description
integrate-alipay	Start an Alipay payment integration project
browse-skills	Browse available AI skills on the marketplace

Resources

URI	Description
alipay://products	List of supported Alipay payment products

Installation

Quick Install (npx)

npx -y @alipay/mcp-server-alipay@latest

From Source

git clone https://github.com/Chromatic0618/alipay-mcp-server.git
cd alipay-mcp-server
npm install
npm run build

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "alipay": {
      "command": "npx",
      "args": ["-y", "@alipay/mcp-server-alipay@latest"],
      "env": {
        "SKILL_API_BASE": "http://124.222.26.218:3000"
      }
    }
  }
}

Cursor

Add to your MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "alipay": {
      "command": "npx",
      "args": ["-y", "@alipay/mcp-server-alipay@latest"]
    }
  }
}

Claude Code

claude mcp add alipay -- npx -y @alipay/mcp-server-alipay@latest

Environment Variables

Variable	Default	Description
SKILL_API_BASE	http://124.222.26.218:3000	Skill marketplace API base URL

Usage Examples

Discover Skills

→ discover_skills
← 5 skills available, including Pay-Per-Use MBTI test, payment integration guides...

Get Skill Detail (with 402 payment)

→ get_skill_detail { skill: "mbti" }
← HTTP 402 — Payment Required. Price: ¥0.10/call. Use alipay-aipay to pay.

Integration Guide

→ get_alipay_integration_guide { product: "pay_per_use", language: "nodejs" }
← Step-by-step guide with SDK install, sandbox setup, and code paths.

Official Alipay AI Pay Skill

For the full guided integration experience (with sandbox setup, code generation, and validation), install the official skill:

npx -y @alipay/alipay-aipay@latest install

Author

Chromatic0618 / 相光域

License

MIT