MCP.so
Sign In
L

Lfwin Payment Mcp

@litsen

Repository

About Lfwin Payment Mcp

LFWin Payment MCP Server 是一个面向 AI Agent 的支付能力服务，通过标准 MCP 协议，将创建支付订单、查询支付状态、发起退款、查询退款状态等能力开放给 Cursor、Cline、Claude Desktop、企业智能助手和自研 Agent 应用。

#payment-mcp-server#cursor-payment-tool#ai-payment-gateway

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "lfwin-payment-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@litsen/lfwin-payment-mcp"
      ]
    }
  }
}

Tools

4

Create a cashier payment order. Amount is in yuan and merchant_order_no is the merchant's own unique order number. After success, display pay_qrcode_markdown, the returned image content block, pay_qrcode_image data URL, or pay_qrcode_base64 with pay_qrcode_mime_type as the QR code. If QR rendering fails, show pay_url/qrcode as the fallback payment link. Save order_no/query_order_no when present. If order_no is null, save merchant_order_no plus order_time and use both for query_payment_order polling.

Query payment order status. Prefer platform order_no/orderid when create_payment_order returned it. If order_no is null, pass merchant_order_no plus order_time returned by create_payment_order. Pass either order_no or the merchant pair.

Create a refund request by platform order_no/orderid. mch_refund_no is the merchant refund number and must be unique per refund. Successful submission means accepted/processing, not final refund success; call query_refund_status to confirm.

Query refund status by platform order_no/orderid. Pass mch_refund_no when available to locate a specific partial refund. Only REFUNDED is final success; REFUNDING/PROCESSING means query again later.

Overview

What is Lfwin Payment Mcp?

LFWin Payment MCP Server is a payment capability service for AI agents. It exposes payment order creation, status querying, refund initiation, and refund status querying via the standard MCP protocol to tools like Cursor, Cline, Claude Desktop, and custom agent applications.

How to use Lfwin Payment Mcp?

Install the Node.js version via npx -y @litsen/lfwin-payment-mcp or the Python version via pip install git+https://github.com/litsen/lfwin-payment-mcp.git. Configure environment variables PAYMENT_API_KEY and PAYMENT_SIGN_KEY, then add a stdio MCP server entry in your client (Cursor, Cline, etc.) pointing to the appropriate command.

Key features of Lfwin Payment Mcp

  • Create unified checkout payment orders with pay URL and QR code
  • Query payment order status by platform order number
  • Initiate refunds against completed payment orders
  • Query refund status by platform order and merchant refund number
  • Provides both Python and Node.js implementations with identical tools

Use cases of Lfwin Payment Mcp

  • An AI agent generates a payment order and presents a QR code for the user to scan and pay.
  • An automated refund workflow triggered by the agent after a payment has been completed.
  • A customer support agent checks the real-time status of a payment or refund order.

FAQ from Lfwin Payment Mcp

What tools does Lfwin Payment Mcp provide?

It provides four MCP tools: create_payment_order, query_payment_order, refund_payment_order, and query_refund_status.

What environment variables are required?

Both implementations require PAYMENT_API_KEY and PAYMENT_SIGN_KEY. Obtain these from the service provider.

Which transport protocol does Lfwin Payment Mcp use?

The server uses the stdio transport for local MCP services. Remote deployment requires adding authentication, tenant isolation, access control, and origin validation.

Are there two separate implementations?

Yes. A Python version in payment_mcp/ and a Node.js version in node-mcp/. They offer the same MCP tools; choose based on your environment.

How should I protect my API keys?

Never commit PAYMENT_API_KEY or PAYMENT_SIGN_KEY to version control. Use environment variables, IDE secrets, or a secret management system.

Frequently asked questions

What tools does Lfwin Payment Mcp provide?

It provides four MCP tools: `create_payment_order`, `query_payment_order`, `refund_payment_order`, and `query_refund_status`.

What environment variables are required?

Both implementations require `PAYMENT_API_KEY` and `PAYMENT_SIGN_KEY`. Obtain these from the service provider.

Which transport protocol does Lfwin Payment Mcp use?

The server uses the `stdio` transport for local MCP services. Remote deployment requires adding authentication, tenant isolation, access control, and origin validation.

Are there two separate implementations?

Yes. A Python version in `payment_mcp/` and a Node.js version in `node-mcp/`. They offer the same MCP tools; choose based on your environment.

How should I protect my API keys?

Never commit `PAYMENT_API_KEY` or `PAYMENT_SIGN_KEY` to version control. Use environment variables, IDE secrets, or a secret management system.

Comments

Basic information

Category

AI & Agents

Transports

stdio

Author

litsen

Submitted by

litsen

More AI & Agents MCP servers

Plainpaper

Plainpaper

The AI marketing canvas for Claude and MCP agents. Your agent drafts campaigns as cards on a shared board, briefed by your brand rules, approved by you.

Sphere

dtajitdinov-aris

Open marketplace where AI agents register, publish services, and transact via escrowed contracts. Live at starsphera.com.

Competitor Tracker & Co.

Competitor Tracker & Co.

Competitor Tracker & Co. watches your competitors' websites and tells you what changed. Every week it crawls their pricing, product, messaging and corporate pages, detects the changes that matter, and files a tagged, ran

scvd.store

seancrecord

The trust layer of the x402 economy. Free conformance checking for any issuer's x402 signed offers and receipts. Settlement attestation on Base and Solana. Weekly signed, Bitcoin-anchored ecosystem corpus.

2

21st.dev Magic AI Agent

21st-dev

It's like v0 but in your Cursor/WindSurf/Cline. 21st dev Magic MCP server for working with your frontend like Magic

5.3K