# payware

> payware is an open-source MCP server for finance and payments. Create and test payware A2A payments, POIs and products from an AI assistant. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Website:** https://payware.eu/en/for-developers
- **Repository:** https://github.com/payware/mcp-server
- **MCP Registry name:** io.github.payware/mcp-server
- **Categories:** finance and payments, developer tools
- **Listing updated:** 2026-11-14

## About

This is payware's official server for merchants, ISVs and payment institutions. Each partner role loads the tools it needs, and a PAYWARE_MCP_TOOLSETS setting can limit loading to groups such as products or placements; the groups are auth, transactions, products, placements, data, logs, poi, shops, onboarding and utils.

The tools cover RSA key and JWT generation for sandbox setup, creating plain, QR and barcode transactions, checking status and history, and simulating callbacks. Point-of-interaction tools set or cancel a price on a POI, fetch its QR code and list a merchant's POIs. Campaign and placement tools need the merchant's PRM plan for changes.

Version 2.2 added partial product and schedule updates through update_product and update_schedule, an execution lock for payment institutions, deferred merchant legs, and payware_generate_code_example, which writes signed example programs for real routes. It runs over stdio from npm and needs a partner ID and a sandbox RSA private key.

## Features

- **Role-based setup:** Works for merchants, ISVs with OAuth2, and payment institutions.
- **Transaction tools:** Create PLAIN, QR and BARCODE transactions and check their status.
- **POI price control:** Set, cancel and read prices on points of interaction and fetch QR codes.
- **Toolset filtering:** Load only chosen groups such as products or placements.
- **Callback simulation:** Test merchant and institution callback scenarios.
- **Signed code examples:** Generate complete example programs for real API routes.

## Good for

- Prototype a payware integration in the sandbox
- Generate JWT-authenticated example code
- Update a product price schedule from chat
- Test payment callbacks before go-live
- Manage POI prices for a shop

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-server --env PAYWARE_OAUTH_CLIENT_SECRET='<PAYWARE_OAUTH_CLIENT_SECRET>' -- npx -y @payware/mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@payware/mcp-server"
      ],
      "env": {
        "PAYWARE_OAUTH_CLIENT_SECRET": "<PAYWARE_OAUTH_CLIENT_SECRET>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@payware/mcp-server"
      ],
      "env": {
        "PAYWARE_OAUTH_CLIENT_SECRET": "<PAYWARE_OAUTH_CLIENT_SECRET>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@payware/mcp-server"
      ],
      "env": {
        "PAYWARE_OAUTH_CLIENT_SECRET": "<PAYWARE_OAUTH_CLIENT_SECRET>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@payware/mcp-server"
      ],
      "env": {
        "PAYWARE_OAUTH_CLIENT_SECRET": "<PAYWARE_OAUTH_CLIENT_SECRET>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@payware/mcp-server"
      ],
      "env": {
        "PAYWARE_OAUTH_CLIENT_SECRET": "<PAYWARE_OAUTH_CLIENT_SECRET>"
      }
    }
  }
}
```

## Tools

- `payware_generate_code_example`: Writes complete, signed example programs for real payware routes.
- `payware_products_get_product_image`: Returns a product image, including for an ISV acting for a merchant.
- `update_product`: Sends only the product fields you give, keeping stored values.
- `update_schedule`: Sends only the schedule fields you give, keeping stored values.

## FAQ

### How do I install it?

Install the npm package @payware/mcp-server; it runs over stdio.

### What credentials are required?

A partner ID and a path to the sandbox RSA private key; a production key and OAuth2 credentials for ISVs are optional.

### What licence is it under?

MIT.

### Can I limit which tools load?

Yes, set PAYWARE_MCP_TOOLSETS to a comma-separated list of toolsets.

### Is payware free?

Yes. payware is open source, so you can use and self-host it for free.

### How do I add payware to Claude Code?

Run this command in your terminal: claude mcp add mcp-server --env PAYWARE_OAUTH_CLIENT_SECRET='<PAYWARE_OAUTH_CLIENT_SECRET>' -- npx -y @payware/mcp-server

### What are the best alternatives to payware?

The closest alternatives to payware are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/payware
