@vaiu/mcp-server

An MCP-compliant stdio server that bridges any MCP client (Claude Desktop, Cursor, etc.) to the Vaiu payment platform.

The server authenticates with your Vaiu credentials on startup — no pre-obtained JWT or agent registration required.

What it exposes

| Tool | Description | |------|-------------| | create_cash_token | Create a cash token another user can redeem | | create_invoice_token | Request payment via invoice token | | redeem_token | Redeem a 6-character token against balance | | get_balance | Get account balance(s) | | get_transactions | Get transaction history | | generate_referral | Generate a referral token |

Prerequisites

• Node.js 20.19+
• A Vaiu account — sign up at vaiu.app
• A client-key — get yours from the Vaiu developer console

Claude Desktop setup

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "vaiu": {
      "command": "npx",
      "args": ["-y", "@vaiu/mcp-server"],
      "env": {
        "VAIU_USERNAME":   "[email protected]",
        "VAIU_PASSWORD":   "your-password",
        "VAIU_CLIENT_KEY": "your-client-key"
      }
    }
  }
}

Fully restart Claude Desktop. The Vaiu tools will appear in the tool picker.

Cursor setup

Add to .cursor/mcp.json in your project (or ~/.cursor/mcp.json globally):

{
  "mcpServers": {
    "vaiu": {
      "command": "npx",
      "args": ["-y", "@vaiu/mcp-server"],
      "env": {
        "VAIU_USERNAME":   "[email protected]",
        "VAIU_PASSWORD":   "your-password",
        "VAIU_CLIENT_KEY": "your-client-key"
      }
    }
  }
}

Environment variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | VAIU_USERNAME | Yes | – | Your Vaiu account email | | VAIU_PASSWORD | Yes | – | Your Vaiu account password | | VAIU_CLIENT_KEY | Yes | – | API client key from developer console | | VAIU_API_BASE | No | https://api.vaiu.io | Vaiu server URL (see below) |

Connecting to a different Vaiu server

By default the bridge connects to the hosted Vaiu platform at https://api.vaiu.io. Set VAIU_API_BASE to point at any Vaiu server — a local dev instance, a staging environment, or a privately deployed Vaiu server (e.g. a bank running their own instance).

Local development:

"env": {
  "VAIU_USERNAME":   "[email protected]",
  "VAIU_PASSWORD":   "your-password",
  "VAIU_CLIENT_KEY": "your-client-key",
  "VAIU_API_BASE":   "http://localhost:3000"
}

Private/self-hosted deployment:

"env": {
  "VAIU_USERNAME":   "[email protected]",
  "VAIU_PASSWORD":   "your-password",
  "VAIU_CLIENT_KEY": "your-client-key",
  "VAIU_API_BASE":   "https://api.yourbank.com"
}

Local development

# Install deps
npm install

# Run manually
[email protected] VAIU_PASSWORD=secret VAIU_CLIENT_KEY=abc123 node index.js

Publishing to npm

cd private/mcp-bridge
npm publish --access public

Vaiu Platform · api.vaiu.io · developer.vaiu.io