pinelabs-mcp 1.0.0 → 1.0.2

package/README.md

@@ -2,22 +2,12 @@
 
 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.
 
-## What is this?
-
-This package connects your AI coding assistant to the Pine Labs MCP (Model Context Protocol) server. Once connected, your AI assistant can:
-
-- Create and manage payment links
-- Process card payments and UPI transactions
-- Handle orders, refunds, and settlements
-- Search transactions and retrieve payment details
-- Generate and validate OTPs
-
-No server setup required. Just install, configure your credentials, and start using Pine Labs tools in your AI assistant.
+> **[Full Documentation](https://developer.pinelabsonline.com/docs/mcp-server-overview)** · **[Available Tools](https://developer.pinelabsonline.com/docs/mcp-server-tools)** · **[Use Cases](https://developer.pinelabsonline.com/docs/mcp-server-use-cases)** · **[FAQs](https://developer.pinelabsonline.com/docs/mcp-server-faqs)**
 
 ## Prerequisites
 
 - **Node.js 18+** — [Download](https://nodejs.org/)
-- **Pine Labs Client Credentials** — Get your `Client ID` and `Client Secret` from the Pine Labs developer portal
+- **Pine Labs Client Credentials** — Get your `Client ID` and `Client Secret` from the [Pine Labs developer portal](https://developer.pinelabsonline.com/)
 
 ## Quick Start
 
@@ -63,60 +53,7 @@ pinelabs-mcp --version                         Show version
 
 ## Manual Configuration
 
-If you prefer to configure your AI client manually:
-
-### Claude Desktop
-
-```json
-{
-  "mcpServers": {
-    "pinelabs": {
-      "command": "npx",
-      "args": ["-y", "pinelabs-mcp"],
-      "env": {
-        "PINELABS_CLIENT_ID": "your_client_id",
-        "PINELABS_CLIENT_SECRET": "your_client_secret"
-      }
-    }
-  }
-}
-```
-
-### Cursor
-
-```json
-{
-  "mcpServers": {
-    "pinelabs": {
-      "command": "npx",
-      "args": ["-y", "pinelabs-mcp"],
-      "env": {
-        "PINELABS_CLIENT_ID": "your_client_id",
-        "PINELABS_CLIENT_SECRET": "your_client_secret"
-      }
-    }
-  }
-}
-```
-
-### VS Code
-
-```json
-{
-  "servers": {
-    "pinelabs": {
-      "command": "npx",
-      "args": ["-y", "pinelabs-mcp"],
-      "env": {
-        "PINELABS_CLIENT_ID": "your_client_id",
-        "PINELABS_CLIENT_SECRET": "your_client_secret"
-      }
-    }
-  }
-}
-```
-
-### Windsurf
+If you prefer to configure manually, add the following to your AI client's MCP config:
 
 ```json
 {
@@ -133,9 +70,9 @@ If you prefer to configure your AI client manually:
 }
 ```
 
-### UAT (Test) Environment
-
-Add `"PINELABS_ENV": "uat"` to the `env` block in any configuration above.
+> **VS Code** uses `"servers"` instead of `"mcpServers"` as the top-level key.
+>
+> **Production environment**: Add `"PINELABS_ENV": "prod"` to the `env` block.
 
 ## Environment Variables
 
@@ -143,89 +80,29 @@ Add `"PINELABS_ENV": "uat"` to the `env` block in any configuration above.
 |----------|----------|---------|-------------|
 | `PINELABS_CLIENT_ID` | Yes | — | Your Pine Labs client ID |
 | `PINELABS_CLIENT_SECRET` | Yes | — | Your Pine Labs client secret |
-| `PINELABS_ENV` | No | `prod` | Environment: `prod` or `uat` |
+| `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
 
-Once connected, your AI assistant will have access to the following Pine Labs tools:
-
-### Payment Links
-| Tool | Description |
-|------|-------------|
-| `create_payment_link` | Create a new payment link |
-| `get_payment_link_by_id` | Retrieve payment link details by ID |
-| `get_payment_link_by_merchant_reference` | Look up payment link by merchant reference |
-| `cancel_payment_link` | Cancel an existing payment link |
-| `resend_payment_link_notification` | Resend payment link notification to customer |
-| `get_payment_link_details` | Get detailed payment link information |
-
-### Orders
-| Tool | Description |
-|------|-------------|
-| `create_order` | Create a new checkout order |
-| `get_order_by_order_id` | Retrieve order details by order ID |
-| `get_order_details` | Get detailed order information |
-| `cancel_order` | Cancel an existing order |
-
-### Payments
-| Tool | Description |
-|------|-------------|
-| `create_card_payment` | Process a card payment |
-| `create_upi_intent_payment_with_qr` | Create a UPI intent payment with QR code |
-| `get_card_details` | Retrieve card details |
-| `search_transaction` | Search for transactions |
-
-### Refunds
-| Tool | Description |
-|------|-------------|
-| `create_refund` | Create a refund for an order |
-| `get_refund_order_details` | Get refund order details |
-| `get_refund_order_by_id` | Retrieve refund details by ID |
-
-### Settlements
-| Tool | Description |
-|------|-------------|
-| `get_all_settlements` | List all settlements |
-| `get_settlements_by_utr` | Look up settlements by UTR number |
-| `release_settlement` | Release a settlement |
-| `cancel_settlement` | Cancel a settlement |
-
-### OTP
-| Tool | Description |
-|------|-------------|
-| `generate_otp` | Generate an OTP for verification |
-| `submit_otp` | Submit an OTP for validation |
-| `resend_otp` | Resend an OTP |
+The MCP server exposes 20+ tools across these categories:
 
-## Troubleshooting
+- **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
 
-### Missing credentials error
+See the [complete tools reference](https://developer.pinelabsonline.com/docs/mcp-server-tools) for details.
 
-Run `npx pinelabs-mcp configure` to set your credentials, or set `PINELABS_CLIENT_ID` and `PINELABS_CLIENT_SECRET` in your MCP client's `env` block.
-
-### Tools not appearing
-
-1. Restart your AI assistant after adding the MCP configuration
-2. Check that Node.js 18+ is installed: `node --version`
-3. Try enabling debug mode: set `"DEBUG": "true"` in the `env` block
-
-### Connection issues
-
-1. Verify your credentials are correct and active
-2. Check your network connection — the server is at `mcp.pluralpay.in`
-3. If behind a corporate proxy, ensure HTTPS traffic to `mcp.pluralpay.in` is allowed
-
-## How it Works
-
-1. Your AI assistant spawns this process via `npx`
-2. Credentials are read from environment variables or stored config (`~/.pinelabs-mcp/config.json`)
-3. The process starts `mcp-remote` which connects to the Pine Labs server
-4. Authentication headers are injected into every request
-5. MCP protocol messages flow transparently between your assistant and the server
+## Troubleshooting
 
-No Pine Labs server code runs locally. All processing happens on Pine Labs hosted infrastructure.
+| 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
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pinelabs-mcp",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "MCP client for Pine Labs payment gateway — connect Claude Desktop, Cursor, and VS Code to Pine Labs payment APIs using your client credentials.",
   "main": "src/config.js",
   "bin": {
@@ -53,5 +53,5 @@
   "dependencies": {
     "mcp-remote": "^0.1.38"
   },
-  "homepage": "https://mcp.pluralpay.in"
+  "homepage": "https://developer.pinelabsonline.com/docs/mcp-server-overview"
 }

package/src/commands/configure.js

@@ -21,7 +21,7 @@ async function configure(flags) {
 function configureFlagMode(flags) {
   const clientId = flags["client-id"] || "";
   const clientSecret = flags["client-secret"] || "";
-  const env = (flags.env || "prod").toLowerCase();
+  const env = (flags.env || "uat").toLowerCase();
 
   if (!clientId) {
     log("\n  Error: --client-id is required.\n");
@@ -73,7 +73,7 @@ async function configureInteractive() {
     return;
   }
 
-  const env = await askQuestion("Environment [prod/uat]", { defaultValue: "prod" });
+  const env = await askQuestion("Environment [uat/prod]", { defaultValue: "uat" });
   const normalizedEnv = env.toLowerCase();
 
   if (!VALID_ENVS.includes(normalizedEnv)) {

package/src/commands/help.js

@@ -36,7 +36,7 @@ function showHelp() {
     $ pinelabs-mcp setup codex --local
     $ pinelabs-mcp setup copilot --print
 
-  Documentation: https://mcp.pluralpay.in
+  Documentation: https://developer.pinelabsonline.com/docs/mcp-server-overview
 `;
 
   process.stderr.write(text);

package/src/commands/setup.js

@@ -86,7 +86,7 @@ function _buildMcpConfig(client, config, options = {}) {
     };
   }
 
-  if (config.environment && config.environment !== "prod") {
+  if (config.environment && config.environment !== "uat") {
     serverEntry.env.PINELABS_ENV = config.environment;
   }
 
@@ -115,7 +115,7 @@ function _buildCodexToml(config, options = {}) {
   lines.push("[mcp_servers.pinelabs.env]");
   lines.push(`PINELABS_CLIENT_ID = "${config.client_id}"`);
   lines.push(`PINELABS_CLIENT_SECRET = "${config.client_secret}"`);
-  if (config.environment && config.environment !== "prod") {
+  if (config.environment && config.environment !== "uat") {
     lines.push(`PINELABS_ENV = "${config.environment}"`);
   }
   lines.push("");

package/src/commands/status.js

@@ -20,8 +20,8 @@ function maskSecret(secret) {
 
 function resolveEndpoint(config) {
   if (config.endpoint) return config.endpoint;
-  const env = config.environment || "prod";
-  return ENDPOINTS[env] || ENDPOINTS.prod;
+  const env = config.environment || "uat";
+  return ENDPOINTS[env] || ENDPOINTS.uat;
 }
 
 function showStatus() {
@@ -42,7 +42,7 @@ function showStatus() {
   log(`  Config file:      ${configPath}`);
   log(`  Client ID:        ${maskId(config.client_id)}`);
   log(`  Client Secret:    ${maskSecret(config.client_secret)}`);
-  log(`  Environment:      ${config.environment || "prod"}`);
+  log(`  Environment:      ${config.environment || "uat"}`);
   log(`  Endpoint:         ${endpoint}`);
 
   try {

package/src/commands/test.js

@@ -17,8 +17,8 @@ function maskId(id) {
 
 function resolveEndpoint(config) {
   if (config.endpoint) return config.endpoint;
-  const env = config.environment || "prod";
-  return ENDPOINTS[env] || ENDPOINTS.prod;
+  const env = config.environment || "uat";
+  return ENDPOINTS[env] || ENDPOINTS.uat;
 }
 
 function probeEndpoint(endpoint, clientId, clientSecret) {
@@ -87,7 +87,7 @@ async function testConnection() {
   }
 
   const endpoint = resolveEndpoint(config);
-  log(`  Environment:  ${config.environment || "prod"}`);
+  log(`  Environment:  ${config.environment || "uat"}`);
   log(`  Endpoint:     ${endpoint}`);
 
   log("\n  Testing connectivity...");

package/src/config.js

@@ -35,14 +35,14 @@ function loadConfig() {
       if (stored) {
         if (!clientId) clientId = stored.client_id || "";
         if (!clientSecret) clientSecret = stored.client_secret || "";
-        if (!env) env = (stored.environment || "prod").toLowerCase();
+        if (!env) env = (stored.environment || "uat").toLowerCase();
       }
     } catch {
       // config-store not available, skip
     }
   }
 
-  if (!env) env = "prod";
+  if (!env) env = "uat";
 
   const errors = [];
 
@@ -76,12 +76,12 @@ function loadConfig() {
   let endpoint;
   if (endpointOverride) {
     endpoint = endpointOverride;
-  } else if (env === "uat") {
-    endpoint = ENDPOINTS.uat;
   } else if (env === "prod") {
     endpoint = ENDPOINTS.prod;
+  } else if (env === "uat") {
+    endpoint = ENDPOINTS.uat;
   } else {
-    endpoint = ENDPOINTS.prod;
+    endpoint = ENDPOINTS.uat;
   }
 
   return { clientId, clientSecret, endpoint, debug };