How do I install the paypay mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `PAYPAY_API_KEY`, `PAYPAY_API_SECRET`, `PAYPAY_MERCHANT_ID`, `PAYPAY_ENV`, `MCP_HTTP_HOST`, `MCP_AUTH_TOKEN` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

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?

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.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
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.

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

Variable	Description	Required
PAYPAY_API_KEY	Credential the server authenticates with.	Yes
PAYPAY_API_SECRET	Credential the server authenticates with.	Yes
PAYPAY_MERCHANT_ID	Configuration value read at startup.	Optional
PAYPAY_ENV	Configuration value read at startup.	Optional
MCP_HTTP_HOST	Endpoint or connection string the server talks to.	Optional
MCP_AUTH_TOKEN	Credential 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

MCP for PayPay (Japan's QR wallet): QR codes, payments, refunds, cancels. Bilingual JP/EN. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.

Alternatives to the Paypay MCP Server

Stripe

Official

Access Stripe billing and payment tools through its MCP server. Connect with OAuth or a supported agent API key and choose the intended account.

Payments & CommerceRemoteTypeScript★ 1.1k

Git

Official

Local repository surgery — status, diffs, commits, branches and history for any repo on disk.

Developer ToolsPython★ 63.0k

Etsy

Etsy tag finder: long-tail tag ideas from live Google autocomplete. Remote MCP server.

Developer ToolsRemote

Sputnikx

EU trade analytics, product catalog, orders, and heating fuel calculator for AI agents.

Analytics & Reporting

Ubuntu Security Notices / USN (usnwatch) — buy per-query in-session

Ubuntu security: USNs per CVE, patched versions. Register in-session — free testnet funds.

Payments & CommerceRemote

Invoicehub

Validate, generate & convert EU e-invoices (UBL, CII, XRechnung, Factur-X) — EN 16931 pre-validated.