PaymentsNZ MCP Server

What is PaymentsNZ MCP Server?

A Model Context Protocol (MCP) server that integrates with Payments NZ APIs, enabling AI assistants like Claude to access account and transaction data from the Payments NZ system.

How to use PaymentsNZ MCP Server?

Install Node.js 22+, run cd sdk && npm install && cd ../mcp-server && npm install to build. Then configure Claude Desktop by adding the server to your claude_desktop_config.json with the command node, argument pointing to the built dist/index.js, and environment variable ACCOUNT_AND_TRANSACTION_API_SPECIFICATION_LIB_ACCESS_TOKEN set to a valid OAuth access token obtained from the Payments NZ authentication portal.

Key features of PaymentsNZ MCP Server

• Integrates with Payments NZ account and transaction APIs
• Uses OAuth-based access tokens for authentication
• Token expires after one hour; must be refreshed
• Requires Node.js version 22 or greater
• Built with a separate SDK directory (sdk/)

Use cases of PaymentsNZ MCP Server

—

FAQ from PaymentsNZ MCP Server

Where do I get an access token?

Go to https://pnz-app.azurewebsites.net/, navigate to any API endpoint, click “GET AUTH TOKEN”, enter credentials, and approve. Copy the displayed token into your environment variable.

How long does the access token last?

The access token does not last more than an hour. It should be used in a timely manner.

What are the runtime requirements?

Node.js version 22 or greater is required. Verify with node --version.

How do I configure the server for Claude Desktop?

Add an entry to your claude_desktop_config.json with "command": "node", "args" pointing to the server’s dist/index.js, and the environment variable containing your access token.

Is there a reference configuration file?

Yes, a claude_desktop_config.json file is provided in the repository as a reference.