About PaymentsNZ MCP Server
A Node.js MCP server for connecting MCP clients to PaymentsNZ APIs. It requires an access token obtained through the PaymentsNZ authentication flow, which remains valid for up to an hour.
Key features
- 01PaymentsNZ API connection
- 02Access-token authentication
- 03Node.js server setup
Use cases
- 01Connect Claude Desktop to PaymentsNZ APIs
- 02Use an authenticated token for API access
MCP support
Runs as an MCP server configured in Claude Desktop and connects clients to PaymentsNZ APIs using an access token.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEPaymentsNZ MCP Server
How to Build
- Install Node.js version 22 or greater. Check version with
node --version. - Run
cd sdk && npm install && cd ../mcp-server && npm installto build the SDK and the server.
How to Run
If you are not familiar with how to setup MCP Servers with Claude Desktop, see this tutorial first.
Now add something like this to your Claude Desktop config:
{
"mcpServers": {
"PaymentsNZ": {
"command": "node",
"args": ["[YOUR-PATH-HERE]/paymentsnz-mcp-server/mcp-server/dist/index.js"],
"env": {
"ACCOUNT_AND_TRANSACTION_API_SPECIFICATION_LIB_ACCESS_TOKEN": "[YOUR-ACCESS-TOKEN-HERE]"
}
}
}
}
A claude_desktop_config.json file is also provided as reference.
Make sure to set the path to the location where your MCP Server is stored as well as the access token you got after authenticating.
How to Get Access Token
- Go to https://pnz-app.azurewebsites.net/
- Go to any endpoint such as https://pnz-app.azurewebsites.net/#/typescript/api-endpoints/statements/get-account-statement
- Click on
GET AUTH TOKENon the top-right of the page and wait for a window to pop-up for consent. - Enter
usernameandpasswordand approve everything - The access token should now be visible in the Authentication UI(See screenshot below). You can now copy it into your environment variables in your
claude_desktop_config.jsonfile.
NOTE: The access token does not last more than an hour. Please make sure that it is used in a timely manner.

Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.