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

alipay-mcp-server

Documentation