pinelabs-mcp

MCP client for Pine Labs payment gateway — connect Claude Desktop, Cursor, VS Code, and other AI assistants to Pine Labs payment APIs using your client credentials.

Full Documentation · Available Tools · Use Cases · FAQs

Prerequisites

• Node.js 18+ — Download
• Pine Labs Client Credentials — Get your Client ID and Client Secret from the Pine Labs developer portal

Install

npm install -g pinelabs-mcp

Why -g? A global install puts pinelabs-mcp on your PATH so you can run commands directly. Without -g, you must prefix every command with npx (e.g. npx pinelabs-mcp test).

Quick Start

# 1. Install globally
npm install -g pinelabs-mcp

# 2. Configure your credentials (saved to ~/.pinelabs-mcp/config.json)
pinelabs-mcp configure --client-id=YOUR_ID --client-secret=YOUR_SECRET

# 3. Test your connection
pinelabs-mcp test

# 4. Auto-configure your AI client
pinelabs-mcp setup cursor       # or: claude-desktop, vscode, windsurf, opencode, copilot, codex

Then restart your AI client and start using Pine Labs tools.

Don't want to install globally? Use npx instead — no installation needed:

npx pinelabs-mcp configure --client-id=YOUR_ID --client-secret=YOUR_SECRET
npx pinelabs-mcp test
npx pinelabs-mcp setup cursor

CLI Commands

pinelabs-mcp start                             Start MCP server (stdio mode)
pinelabs-mcp configure                         Interactive credential setup
pinelabs-mcp configure --client-id=X --client-secret=Y [--env=uat|prod]
pinelabs-mcp test                              Test connectivity and credentials
pinelabs-mcp setup <client>                    Auto-configure an AI client
pinelabs-mcp setup <client> --print            Preview config without writing
pinelabs-mcp status                            Show current configuration
pinelabs-mcp help                              Show help message
pinelabs-mcp --version                         Show version

Supported AI Clients

| Client | Command | Config Path | |--------|---------|-------------| | Claude Desktop | setup claude-desktop | Platform-specific Claude config | | Cursor | setup cursor | ~/.cursor/mcp.json | | VS Code | setup vscode | .vscode/mcp.json (project) | | Windsurf | setup windsurf | ~/.codeium/windsurf/mcp_config.json | | OpenCode | setup opencode | .opencode/config.json (project) | | GitHub Copilot | setup copilot | ~/.copilot/mcp-config.json | | OpenAI Codex | setup codex | .codex/config.toml |

Manual Configuration

If you prefer to configure manually, add the following to your AI client's MCP config:

{
  "mcpServers": {
    "pinelabs": {
      "command": "npx",
      "args": ["-y", "pinelabs-mcp"],
      "env": {
        "PINELABS_CLIENT_ID": "your_client_id",
        "PINELABS_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

VS Code uses "servers" instead of "mcpServers" as the top-level key.

Production environment: Add "PINELABS_ENV": "prod" to the env block.

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | PINELABS_CLIENT_ID | Yes | — | Your Pine Labs client ID | | PINELABS_CLIENT_SECRET | Yes | — | Your Pine Labs client secret | | PINELABS_ENV | No | uat | Environment: uat or prod | | PINELABS_MCP_ENDPOINT | No | — | Custom endpoint URL (overrides PINELABS_ENV) | | DEBUG | No | false | Enable debug logging (true or 1) |

Available Tools

The MCP server exposes 20+ tools across these categories:

• Payment Links — Create, retrieve, cancel, and resend payment links
• Orders — Create, track, and cancel checkout orders
• Payments — QR Code Generation for UPI payments
• Refunds — Create and retrieve refund details
• Settlements — Settlements APIs

See the complete tools reference for details.

Troubleshooting

| Issue | Fix | |-------|-----| | Missing credentials | Run npx pinelabs-mcp configure or set PINELABS_CLIENT_ID / PINELABS_CLIENT_SECRET in your MCP client's env block | | Tools not appearing | Restart your AI assistant; verify Node.js 18+ (node --version); set "DEBUG": "true" in env | | Connection issues | Verify credentials; check network access to mcp.pluralpay.in; allow HTTPS if behind a proxy |

License

Apache 2.0 — see LICENSE