Paypay MCP Server

MCP for PayPay (Japan's QR wallet): QR codes, payments, refunds, cancels. Bilingual JP/EN.

Local serverstdio

What is the Paypay MCP server?

Most payments and commerce work still happens through a UI a human drives. Paypay MCP server moves it into the conversation instead. MCP for PayPay (Japan's QR wallet): QR codes, payments, refunds, cancels. Bilingual JP/EN.

The short version

Model Context Protocol server for the PayPay Open Payment API.

The tools it exposes

The server publishes 7 tools. What each one is for:

  • create_qr_code — Create a dynamic PayPay QR code. Returns the payment URL, deeplink, and a rendered PNG
  • get_payment_details — Fetch the current status of a payment
  • wait_for_payment — Poll until a payment reaches a terminal state
  • delete_qr_code — Invalidate a QR code before payment
  • refund_payment — Full or partial refund. Disabled unless PAYPAY_ENABLE_REFUNDS=true.
  • cancel_payment — Cancel a payment when its state is unclear (timeout or error). Disabled unless PAYPAY_ENABLE_CANCELS=true.
  • Cursor — Add to ~/.cursor/mcp.json with the same shape as Claude Desktop

Getting it running

paypay-mcp on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

What it needs from you

Configuration is passed through the environment: PAYPAY_API_KEY, PAYPAY_API_SECRET, PAYPAY_MERCHANT_ID, PAYPAY_ENV, MCP_HTTP_HOST, MCP_AUTH_TOKEN. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

How it compares

This sits in the payments and commerce group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Paypay's toolset — create_qr_code, get_payment_details, wait_for_payment and 4 more — is a fair guide to whether it matches your workflow. It is maintained by mrslbt; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
create_qr_codeCreate a dynamic PayPay QR code. Returns the payment URL, deeplink, and a rendered PNG.
get_payment_detailsFetch the current status of a payment.
wait_for_paymentPoll until a payment reaches a terminal state.
delete_qr_codeInvalidate a QR code before payment.
refund_paymentFull or partial refund. **Disabled unless PAYPAY_ENABLE_REFUNDS=true.**
cancel_paymentCancel a payment when its state is unclear (timeout or error). **Disabled unless PAYPAY_ENABLE_CANCELS=true.**
CursorAdd to ~/.cursor/mcp.json with the same shape as Claude Desktop.

How to install the Paypay MCP server

{
  "mcpServers": {
    "paypay": {
      "command": "npx",
      "args": ["-y", "paypay-mcp"],
      "env": {
        "PAYPAY_API_KEY": "your-value",
        "PAYPAY_API_SECRET": "your-value",
        "PAYPAY_MERCHANT_ID": "your-value",
        "PAYPAY_ENV": "your-value",
        "MCP_HTTP_HOST": "your-value",
        "MCP_AUTH_TOKEN": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
PAYPAY_API_KEYCredential the server authenticates with.Yes
PAYPAY_API_SECRETCredential the server authenticates with.Yes
PAYPAY_MERCHANT_IDConfiguration value read at startup.Optional
PAYPAY_ENVConfiguration value read at startup.Optional
MCP_HTTP_HOSTEndpoint or connection string the server talks to.Optional
MCP_AUTH_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • Use Paypay to create qr code.
  • Use Paypay to get payment details.
  • Use Paypay to wait for payment.

Frequently asked questions

It connects Paypay to MCP-compatible AI assistants such as Claude and Cursor, exposing 7 tools (create_qr_code, get_payment_details, wait_for_payment, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Paypay directly.