payware MCP Server

by paywareio.github.payware/mcp-serverv1.3.3

payware A2A payments API for merchants, ISVs and payment institutions

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active11d ago

Install payware MCP server

claude mcp add payware -e PAYWARE_PARTNER_ID='<payware-partner-id>' -e PAYWARE_SANDBOX_PRIVATE_KEY_PATH='<payware-sandbox-private-key-path>' -e PAYWARE_OAUTH_CLIENT_SECRET='<payware-oauth-client-secret>' -- npx -y @payware/mcp-server

{
  "mcpServers": {
    "payware": {
      "command": "npx",
      "args": [
        "-y",
        "@payware/mcp-server"
      ],
      "env": {
        "PAYWARE_PARTNER_ID": "<payware-partner-id>",
        "PAYWARE_SANDBOX_PRIVATE_KEY_PATH": "<payware-sandbox-private-key-path>",
        "PAYWARE_OAUTH_CLIENT_SECRET": "<payware-oauth-client-secret>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "payware": {
      "command": "npx",
      "args": [
        "-y",
        "@payware/mcp-server"
      ],
      "env": {
        "PAYWARE_PARTNER_ID": "<payware-partner-id>",
        "PAYWARE_SANDBOX_PRIVATE_KEY_PATH": "<payware-sandbox-private-key-path>",
        "PAYWARE_OAUTH_CLIENT_SECRET": "<payware-oauth-client-secret>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "payware": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@payware/mcp-server"
      ],
      "env": {
        "PAYWARE_PARTNER_ID": "<payware-partner-id>",
        "PAYWARE_SANDBOX_PRIVATE_KEY_PATH": "<payware-sandbox-private-key-path>",
        "PAYWARE_OAUTH_CLIENT_SECRET": "<payware-oauth-client-secret>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "payware": {
      "command": "npx",
      "args": [
        "-y",
        "@payware/mcp-server"
      ],
      "env": {
        "PAYWARE_PARTNER_ID": "<payware-partner-id>",
        "PAYWARE_SANDBOX_PRIVATE_KEY_PATH": "<payware-sandbox-private-key-path>",
        "PAYWARE_OAUTH_CLIENT_SECRET": "<payware-oauth-client-secret>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
PAYWARE_PARTNER_TYPE	—	—	Partner role: merchant, isv or payment_institution
PAYWARE_PARTNER_ID	yes	—	Partner ID from the payware dashboard
PAYWARE_SANDBOX_PRIVATE_KEY_PATH	yes	—	Path to the RSA private key for the sandbox
PAYWARE_PRODUCTION_PRIVATE_KEY_PATH	—	—	Path to the RSA private key for production
PAYWARE_OAUTH_CLIENT_ID	—	—	OAuth2 client ID (ISV partners only)
PAYWARE_OAUTH_CLIENT_SECRET	—	yes	OAuth2 client secret (ISV partners only)

Freshness

Active — last maintenance signal 11d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-28 · 11d ago · GitHub
Latest release
2026-09-28 · 11d ago · GitHub · v1.3.3
Package published
no data · npm/PyPI
Registry entry updated
2026-09-28 · 11d ago · official registry · v1.3.3

FAQ

›How do I install the payware MCP server in Claude Code?

Run: claude mcp add payware -e PAYWARE_PARTNER_ID='<payware-partner-id>' -e PAYWARE_SANDBOX_PRIVATE_KEY_PATH='<payware-sandbox-private-key-path>' -e PAYWARE_OAUTH_CLIENT_SECRET='<payware-oauth-client-secret>' -- npx -y @payware/mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does payware require an API key?

Yes. It expects PAYWARE_PARTNER_ID, PAYWARE_SANDBOX_PRIVATE_KEY_PATH, PAYWARE_OAUTH_CLIENT_SECRET, of which 1 is a secret.

›Can I use payware as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is payware in the official MCP registry?

Yes, as io.github.payware/mcp-server.