[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_107":108},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module '@plural-pinelabs/pinelabs-online-mcp' is not configured","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":26,"_34":-5,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":48,"_56":57,"_58":59,"_60":-5,"_61":-5,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":-5,"_76":77,"_78":48,"_79":-5,"_80":81,"_82":83,"_84":85,"_86":87,"_88":89,"_90":91,"_92":93},"apiUrl","https://odel.app/api","creator","plural-pinelabs","moduleId","pinelabs-online-mcp","@plural-pinelabs/pinelabs-online-mcp","displayName","PineLabs Plural PG — Payment Gateway MCP Server","tagline","Create payment orders, checkout, subscriptions & UPI via PineLabs Plural PG gateway","iconKey","https://avatars.githubusercontent.com/u/188297571?v=4","category","dev-tools","status","published","metaDescription","metaKeywords","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://mcp.pinelabs.com/mcp\",\"transport\":\"streamable-http\",\"authType\":\"headers\",\"requiredSecrets\":[\"X_CLIENT_ID\",\"X_CLIENT_SECRET\"]}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363654000,"updatedAt",1781499976000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.plural-pinelabs%2Fpinelabs-online-mcp","sourceVerified",true,"importedAt","upstreamStars",1,"upstreamUpdatedAt",1778676001000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/plural-pinelabs/pinelabs-online-mcp","githubRepoFullName","plural-pinelabs/pinelabs-online-mcp","releaseId","ext-plural-pinelabs-pinelabs-online-mcp","version","0.1.2","descriptionMarkdown","# Pine Labs Payment Gateway MCP Server (Official)\n\n\n\n[![npm package](https://img.shields.io/npm/v/pinelabs-mcp.svg)](https://www.npmjs.com/package/pinelabs-mcp)\n\nMCP 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.\n\n[Full Documentation](#available-tools) | [Available Tools](#available-tools) | [Use Cases](#use-cases) | [FAQs](#faq)\n\n---\n\n## Table of Contents\n\n- [Prerequisites](#prerequisites)\n- [Quick Start](#quick-start)\n- [CLI Commands](#cli-commands)\n- [Supported AI Clients](#supported-ai-clients)\n- [Manual Configuration](#manual-configuration)\n- [Available Tools](#available-tools)\n- [Use Cases](#use-cases)\n- [Remote MCP Server](#remote-mcp-server)\n- [Authentication](#authentication)\n- [Local MCP Server](#local-mcp-server)\n- [Configuration](#configuration)\n- [Debugging](#debugging-the-server)\n- [FAQ](#faq)\n- [Keywords](#keywords)\n- [License](#license)\n\n---\n\n## Prerequisites\n\n- **Node.js 18+** -- [Download](https://nodejs.org/) or install npm i pinelabs-mcp\n- **Pine Labs Client Credentials** -- Get your Client ID and Client Secret from the [Pine Labs developer portal](https://developer.pinelabsonline.com/docs/mcp-server-overview)\n\n---\n\n## Quick Start\n\n### Getting Your Credentials\n\n1. Sign up or log in to the Pine Labs merchant dashboard provided with your account.\n2. Navigate to your account settings to locate your **Client ID** and **Client Secret**.\n3. Use these credentials in the MCP server configuration as shown in the setup instructions above.\n\n### Configure and Connect\n\n```bash\n# 1. Configure your credentials\nnpx pinelabs-mcp configure --client-id=YOUR_ID --client-secret=YOUR_SECRET\n\n# 2. Test your connection\nnpx pinelabs-mcp test\n\n# 3. Auto-configure your AI client\nnpx pinelabs-mcp setup cursor # or: claude-desktop, vscode, windsurf, opencode, copilot, codex\n```\n\nThen restart your AI client and start using Pine Labs tools.\n\n---\n\n## CLI Commands\n\n```\npinelabs-mcp start Start MCP server (stdio mode)\npinelabs-mcp configure Interactive credential setup\npinelabs-mcp configure --client-id=X --client-secret=Y [--env=uat|prod]\npinelabs-mcp test Test connectivity and credentials\npinelabs-mcp setup Auto-configure an AI client\npinelabs-mcp setup --local Use local path (dev mode)\npinelabs-mcp setup --print Preview config without writing\npinelabs-mcp status Show current configuration\npinelabs-mcp help Show help message\npinelabs-mcp --version Show version\n```\n\n---\n\n## Supported AI Clients\n\n| Client | Command | Config Path |\n|:-------|:--------|:------------|\n| Claude Desktop | `setup claude-desktop` | Platform-specific Claude config |\n| Cursor | `setup cursor` | `~/.cursor/mcp.json` |\n| VS Code | `setup vscode` | `.vscode/mcp.json` (project) |\n| Windsurf | `setup windsurf` | `~/.codeium/windsurf/mcp_config.json` |\n| OpenCode | `setup opencode` | `.opencode/config.json` (project) |\n| GitHub Copilot | `setup copilot` | `~/.copilot/mcp-config.json` |\n| OpenAI Codex | `setup codex` | `.codex/config.toml` |\n\n---\n\n## Manual Configuration\n\nIf you prefer to configure manually instead of using `npx pinelabs-mcp setup`, add the following to your AI client's MCP config:\n\n```json\n{\n \"mcpServers\": {\n \"pinelabs\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"pinelabs-mcp\"],\n \"env\": {\n \"PINELABS_CLIENT_ID\": \"your_client_id\",\n \"PINELABS_CLIENT_SECRET\": \"your_client_secret\"\n }\n }\n }\n}\n```\n\n> **Note:** VS Code uses `\"servers\"` instead of `\"mcpServers\"` as the top-level key. For production environment, add `\"PINELABS_ENV\": \"prod\"` to the `env` block.\n\n---\n\n## Available Tools\n\nThe Pine Labs MCP Server exposes 50+ tools across multiple categories. Each tool maps to a specific Pine Labs payment API endpoint.\n\n### Tool Type Legend\n\nEach tool below is tagged with a **Type** indicating its access pattern and operational risk. This helps you reason about which tools are safe in read-only deployments and which require explicit user confirmation in autonomous (agentic) flows.\n\n| Type | Meaning | Examples |\n|:-----|:--------|:---------|\n| **Read** | Safe, side-effect-free. Fetches or queries data only. Allowed in read-only mode. | `get_order_by_order_id`, `get_all_settlements`, `list_plural_apis` |\n| **Write** | Creates or modifies resources. Not destructive but mutates server state. Skipped in read-only mode. | `create_payment_link`, `create_order`, `update_plan` |\n| **Destructive** | Cancels, deletes, refunds, or moves money. Irreversible or financially impactful. **Should require explicit user confirmation in agent flows.** | `cancel_order`, `create_refund`, `create_payout`, `delete_plan` |\n\n> **Read-only mode:** Run the server with `--read-only` (or set the equivalent config) to register only `Read` tools and skip all `Write` / `Destructive` toolsets. Useful for analytics, monitoring, or untrusted agent contexts.\n\n### Payment Links\n\n\n| Tool | Type | Description | API Reference |\n|:-----|:-----|:------------|:--------------|\n| `create_payment_link` | Write | Create a new payment link for collecting payments | [Payment Link - Create](https://developer.pinelabsonline.com/reference/payment-link-create) |\n| `get_payment_link_by_id` | Read | Fetch a payment link by its payment link ID | [Payment Link - Get by ID](https://developer.pinelabsonline.com/reference/payment-link-get-by-payment-link-id) |\n| `get_payment_link_by_merchant_reference` | Read | Fetch a payment link by its merchant payment link reference | [Payment Link - Get by Reference](https://developer.pinelabsonline.com/reference/payment-link-get-by-merchant-payment-link-reference) |\n| `cancel_payment_link` | Destructive | Cancel an active payment link | [Payment Link - Cancel](https://developer.pinelabsonline.com/reference/payment-link-cancel) |\n| `resend_payment_link_notification` | Write | Resend a payment link notification to the customer | [Payment Link - Resend](https://developer.pinelabsonline.com/reference/payment-link-resend) |\n\n### Orders\n\n| Tool | Type | Description | API Reference |\n|:-----|:-----|:------------|:--------------|\n| `get_order_by_order_id` | Read | Retrieve order details by order ID | [Order - Get by ID](https://developer.pinelabsonline.com/reference/orders-get-by-order-id) |\n| `get_order_by_merchant_order_reference` | Read | Retrieve order details by merchant order reference | [Order - Get by Merchant Reference](https://developer.pinelabsonline.com/reference/orders-get-by-merchant-order-reference) |\n| `capture_order` | Write | Capture a previously authorized payment against an order | [Order - Capture](https://developer.pinelabsonline.com/reference/orders-capture) |\n| `cancel_order` | Destructive | Cancel a pre-authorized payment against an order | [Order - Cancel](https://developer.pinelabsonline.com/reference/orders-cancel) |\n| `fetch_order_payments` | Read | Fetch all payment attempts associated with an order | [Order - Get Payments](https://developer.pinelabsonline.com/reference/orders-get-payments) |\n\n### Checkout Orders\n\n| Tool | Type | Description | API Reference |\n|:-----|:-----|:------------|:--------------|\n| `create_order` | Write | Create a new checkout order and generate a checkout link | [Order - Create](https://developer.pinelabsonline.com/reference/orders-create) |\n\n### Card Payments\n\n| Tool | Type | Description | API Reference |\n|:-----|:-----|:------------|:--------------|\n| `create_card_payment` | Write | Create a server-to-server card payment against an order | [Card Payment - Create](https://developer.pinelabsonline.com/reference/payments-create-card-payment) |\n| `get_card_details` | Read | Retrieve card details (BIN, network, type) for a card number | [Card Details - Get](https://developer.pinelabsonline.com/reference/get-card-details) |\n\n### OTP\n\n| Tool | Type | Description | API Reference |\n|:-----|:-----|:------------|:--------------|\n| `generate_otp` | Write | Generate an OTP for a card payment authentication flow | [OTP - Generate](https://developer.pinelabsonline.com/reference/generate-otp) |\n| `submit_otp` | Write | Submit an OTP to complete a card payment authentication | [OTP - Submit](https://developer.pinelabsonline.com/reference/submit-otp) |\n| `resend_otp` | Write | Resend an OTP for a card payment authentication | [OTP - Resend](https://developer.pinelabsonline.com/reference/resend-otp) |\n\n### Refunds\n\n| Tool | Type | Description | API Reference |\n|:-----|:-----|:------------|:--------------|\n| `create_refund` | Destructive | Initiate a full or partial refund against a captured payment | [Refund - Create](https://developer.pinelabsonline.com/reference/refund-create) |\n\n### Settlements\n\n| Tool | Type | Description | API Reference |\n|:-----|:-----|:------------|:--------------|\n| `get_all_settlements` | Read | Retrieve all settlements for the merchant within a date range | [Settlements - Get All](https://developer.pinelabsonline.com/reference/get-all-settlements) |\n| `get_settlement_by_utr` | Read | Retrieve a specific settlement by its UTR (Unique Transaction Reference) | [Settlement - Get by UTR](https://developer.pinelabsonline.com/reference/get-settlement-by-utr) |\n\n### Payouts\n\n| Tool | Type | Description | API Reference |\n|:-----|:-----|:------------|:--------------|\n| `create_payout` | Destructive | Create a payout to disburse funds to a beneficiary (moves money) | [Payout - Create](https://developer.pinelabsonline.com/reference/create-payout) |\n| `get_payout_details` | Read | Retrieve details of a payout by payout ID | [Payout - Get](https://developer.pinelabsonline.com/reference/get-payout) |\n| `get_payout_payments` | Read | List payments associated with a payout | [Payout - Get Payments](https://developer.pinelabsonline.com/reference/get-payout-payments) |\n| `get_payout_balance` | Read | Retrieve the available payout balance for the merchant | [Payout - Get Balance](https://developer.pinelabsonline.com/reference/get-payout-balance) |\n| `update_payout` | Write | Update an existing payout request | [Payout - Update](https://developer.pinelabsonline.com/reference/update-payout) |\n| `cancel_payout` | Destructive | Cancel a pending payout request | [Payout - Cancel](https://developer.pinelabsonline.com/reference/cancel-payout) |\n\n### Subscriptions\n\n| Tool | Type | Description | API Reference |\n|:-----|:-----|:------------|:--------------|\n| `create_plan` | Write | Create a new subscription plan | [Plan - Create](https://developer.pinelabsonline.com/reference/create-plan) |\n| `get_plans` | Read | Retrieve subscription plans | [Plan - Get All](https://developer.pinelabsonline.com/reference/get-all-plans) |\n| `get_plan_by_id` | Read | Retrieve a subscription plan by plan ID | [Plan - Get Specific](https://developer.pinelabsonline.com/reference/get-specific-plan) |\n| `get_plan_by_merchant_reference` | Read | Retrieve a plan by merchant plan reference | [Plan - Get Specific](https://developer.pinelabsonline.com/reference/get-specific-plan) |\n| `update_plan` | Write | Update an existing subscription plan | [Plan - Update](https://developer.pinelabsonline.com/reference/update-plan) |\n| `delete_plan` | Destructive | Delete a subscription plan | [Plan - Delete](https://developer.pinelabsonline.com/reference/delete-plan) |\n| `create_subscription` | Write | Create a new subscription against a plan | [Subscription - Create](https://developer.pinelabsonline.com/reference/create-subscription) |\n| `get_subscriptions` | Read | Retrieve subscriptions | [Subscription - Get All](https://developer.pinelabsonline.com/reference/get-all-subscriptions) |\n| `get_subscription_by_id` | Read | Retrieve a subscription by subscription ID | [Subscription - Get Specific](https://developer.pinelabsonline.com/reference/get-specific-subscription) |\n| `get_subscription_by_merchant_reference` | Read | Retrieve a subscription by merchant reference | [Subscription - Get Specific](https://developer.pinelabsonline.com/reference/get-specific-subscription) |\n| `pause_subscription` | Write | Pause an active subscription | [Subscription - Pause](https://developer.pinelabsonline.com/reference/pause-subscription) |\n| `resume_subscription` | Write | Resume a paused subscription | [Subscription - Resume](https://developer.pinelabsonline.com/reference/resume-subscription) |\n| `cancel_subscription` | Destructive | Cancel an active subscription | [Subscription - Cancel](https://developer.pinelabsonline.com/reference/cancel-subscription) |\n| `update_subscription` | Write | Update an existing subscription | [Subscription - Update](https://developer.pinelabsonline.com/reference/update-subscription) |\n| `create_presentation` | Write | Create a presentation (payment request) for a subscription | [Presentation - Create](https://developer.pinelabsonline.com/reference/create-presentation) |\n| `get_presentation` | Read | Retrieve a presentation by presentation ID | [Presentation - Get](https://developer.pinelabsonline.com/reference/get-presentation) |\n| `delete_presentation` | Destructive | Delete a presentation | [Presentation - Delete](https://developer.pinelabsonline.com/reference/delete-presentation) |\n| `get_presentations_by_subscription_id` | Read | Retrieve all presentations for a subscription | [Presentation - Get by Subscription](https://developer.pinelabsonline.com/reference/get-presentation-by-subscription-id) |\n| `get_presentation_by_merchant_reference` | Read | Retrieve a presentation by merchant reference | [Presentation - Get](https://developer.pinelabsonline.com/reference/get-presentation) |\n| `send_subscription_notification` | Write | Send a pre-debit notification for a subscription | [Presentation - Create](https://developer.pinelabsonline.com/reference/create-presentation) |\n| `create_debit` | Destructive | Execute a debit (payment collection) against a subscription | [Presentation - Create](https://developer.pinelabsonline.com/reference/create-presentation) |\n| `create_merchant_retry` | Write | Retry mandate execution for a failed debit (max 3 retries) | [Merchant Retry](https://developer.pinelabsonline.com/reference/create-merchant-retry) |\n\n### UPI Payments\n\n| Tool | Type | Description | API Reference |\n|:-----|:-----|:------------|:--------------|\n| `create_upi_intent_payment_with_qr` | Write | Create a UPI intent payment with QR code for instant collection | [UPI Intent QR](https://developer.pinelabsonline.com/reference/create-intent-payment-with-qr-image) |\n\n### Reports and Transaction Search\n\n| Tool | Type | Description | API Reference |\n|:-----|:-----|:------------|:--------------|\n| `get_payment_link_details` | Read | Fetch payment link details within a date range | [API Docs](https://developer.pinelabsonline.com/docs/mcp-server-overview) |\n| `get_order_details` | Read | Fetch order details within a date range | [API Docs](https://developer.pinelabsonline.com/docs/mcp-server-overview) |\n| `get_refund_order_details` | Read | Fetch refund order details within a date range | [API Docs](https://developer.pinelabsonline.com/docs/mcp-server-overview) |\n| `search_transaction` | Read | Search for a transaction by transaction ID | [API Docs](https://developer.pinelabsonline.com/docs/mcp-server-overview) |\n\n### Developer Tools\n\n| Tool | Type | Description |\n|:-----|:-----|:------------|\n| `get_api_documentation` | Read | Fetch Pine Labs API documentation for a specific API |\n| `list_plural_apis` | Read | List all available Pine Labs (Plural) APIs with descriptions |\n| `detect_stack` | Read | Detect the technology stack of the current project to tailor integration guidance |\n| `integrate_pinelabs_checkout` | Read | Generate stack-aware code snippets and integration guidance for Pine Labs Checkout |\n\n### Merchant Analytics\n\n| Tool | Type | Description |\n|:-----|:-----|:------------|\n| `get_merchant_success_rate` | Read | Fetch transaction success rate for the merchant over a date range |\n\n---\n\n## Use Cases\n\n- **Payment Gateway Integration**: Connect your AI application to the Pine Labs payment gateway to create checkout orders, generate payment links, and process transactions programmatically.\n- **AI-Powered Checkout Flows**: Build conversational checkout experiences where AI assistants create orders, generate payment links, and track payment status in real time.\n- **UPI Payment Automation**: Generate UPI intent QR codes and process UPI payments through AI-driven interfaces for in-app or point-of-sale collection.\n- **Subscription Lifecycle Management**: Automate recurring payment plan creation, subscription activation, pause/resume cycles, debit presentations, and pre-debit notifications.\n- **Agentic Payment Workflows**: Build autonomous AI agents that manage end-to-end payment operations -- from order creation through reconciliation -- without manual intervention.\n- **Order Tracking and Reconciliation**: Query order details, search transactions by ID, and reconcile payments to verify statuses and resolve disputes.\n- **Payment Analytics and Reporting**: Retrieve payment link reports, order summaries, refund details, and merchant success rates over custom date ranges.\n- **Customer Support Automation**: Enable support agents or chatbots to look up transactions, check payment statuses, cancel orders, and resend payment notifications.\n\n---\n\n## Remote MCP Server\n\nThe Remote MCP Server is hosted and maintained by Pine Labs. Use this approach if you prefer to configure your AI client manually with the remote endpoint instead of using the [npm CLI](#quick-start).\n\n### Benefits\n\n- **Zero Setup**: No Python, Docker, or local infrastructure to manage\n- **Always Updated**: Automatic updates with the latest payment API features and security patches\n- **High Availability**: Hosted on Pine Labs production infrastructure\n- **Secure Authentication**: Client credential authentication over HTTPS\n\nIf you are connecting to a self-hosted remote deployment instead of the\nPine Labs hosted service, replace the remote URL below with\n``.\n\n### Prerequisites\n\n`npx` is required to proxy the remote MCP connection.\nInstall Node.js (which includes `npm` and `npx`):\n\n#### macOS\n```bash\nbrew install node\n```\n\n#### Windows\n```bash\nchoco install nodejs\n```\n\nAlternatively, download from [https://nodejs.org/](https://nodejs.org/).\n\n#### Verify Installation\n```bash\nnpx --version\n```\n\n### Usage with Cursor\n\nAdd the following to your Cursor MCP settings:\n\n```json\n{\n \"mcpServers\": {\n \"pinelabs\": {\n \"command\": \"npx\",\n \"args\": [\n \"mcp-remote\",\n \"https://mcp.pinelabs.com/mcp\",\n \"--header\",\n \"X-Client-Id:\",\n \"--header\",\n \"X-Client-Secret:\"\n ]\n }\n }\n}\n```\n\nReplace `` and `` with your Pine Labs credentials. See [Authentication](#authentication) for details.\n\n### Usage with Claude Desktop\n\nAdd the following to your `claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"pinelabs\": {\n \"command\": \"npx\",\n \"args\": [\n \"mcp-remote\",\n \"https://mcp.pinelabs.com/mcp\",\n \"--header\",\n \"X-Client-Id:\",\n \"--header\",\n \"X-Client-Secret:\"\n ]\n }\n }\n}\n```\n\nReplace `` and `` with your Pine Labs credentials.\n\n- Configure MCP servers in Claude Desktop: [MCP Quickstart Guide](https://modelcontextprotocol.io/quickstart/user)\n- Install Claude Desktop: [Download](https://claude.ai/download)\n\n### Usage with VS Code\n\nAdd the following to your VS Code settings (JSON):\n\n```json\n{\n \"mcp\": {\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"pinelabs_client_id\",\n \"description\": \"Pine Labs Client ID\"\n },\n {\n \"type\": \"promptString\",\n \"id\": \"pinelabs_client_secret\",\n \"description\": \"Pine Labs Client Secret\",\n \"password\": true\n }\n ],\n \"servers\": {\n \"pinelabs\": {\n \"command\": \"npx\",\n \"args\": [\n \"mcp-remote\",\n \"https://mcp.pinelabs.com/mcp\",\n \"--header\",\n \"X-Client-Id:${input:pinelabs_client_id}\",\n \"--header\",\n \"X-Client-Secret:${input:pinelabs_client_secret}\"\n ]\n }\n }\n }\n}\n```\n\nLearn more about MCP servers in VS Code's [agent mode documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers).\n\n---\n\n## Authentication\n\nThe MCP server authenticates using **Client ID** and **Client Secret** credentials issued by Pine Labs.\n\n> **Note:** For local deployments, credentials can be passed via CLI arguments or environment variables. For the remote server, credentials are passed as HTTP headers.\n\n---\n\n## Local MCP Server\n\nDeploy the MCP server on your own infrastructure for full control over the runtime environment.\n\n### Prerequisites\n\n- Python 3.12+\n- Docker (optional, for containerized deployment)\n- Git\n\n### Install on Windows (Chocolatey)\n\nThe fastest way to get the MCP server on a Windows machine is via [Chocolatey](https://chocolatey.org/). The package is a thin wrapper that installs Python 3.10+ as a dependency and then installs `pinelabs-mcp-server` from PyPI, registering a `pinelabs-mcp` shim on `PATH`.\n\n```powershell\nchoco install pinelabs-mcp\n```\n\nVerify the install:\n\n```powershell\npinelabs-mcp --help\n```\n\nRun the server over stdio:\n\n```powershell\npinelabs-mcp stdio --client-id --client-secret --env uat\n```\n\n#### MCP client configuration (Claude Desktop / Cursor / VS Code)\n\nAfter `choco install`, point your MCP client at the `pinelabs-mcp` shim:\n\n```json\n{\n \"mcpServers\": {\n \"pinelabs\": {\n \"command\": \"pinelabs-mcp\",\n \"args\": [\"stdio\", \"--env\", \"uat\"],\n \"env\": {\n \"PINELABS_CLIENT_ID\": \"\",\n \"PINELABS_CLIENT_SECRET\": \"\"\n }\n }\n }\n}\n```\n\nTo uninstall:\n\n```powershell\nchoco uninstall pinelabs-mcp\n```\n\n### Using Public Docker Image (Recommended)\n\nUse the official Pine Labs Docker image directly. No build step required.\n\n> **Note:** To pin a specific version, replace `pinelabs/mcp:latest` with `pinelabs/mcp:` (e.g., `pinelabs/mcp:v1.0.0`) in the configurations below.\n\n#### Usage with Claude Desktop\n\nAdd the following to your `claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"pinelabs\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\",\n \"PINELABS_CLIENT_ID\",\n \"-e\",\n \"PINELABS_CLIENT_SECRET\",\n \"-e\",\n \"PINELABS_ENV\",\n \"pinelabs/mcp:latest\"\n ],\n \"env\": {\n \"PINELABS_CLIENT_ID\": \"\",\n \"PINELABS_CLIENT_SECRET\": \"\",\n \"PINELABS_ENV\": \"prod\"\n }\n }\n }\n}\n```\n\nReplace `` and `` with your Pine Labs credentials.\n\n- Configure MCP servers in Claude Desktop: [MCP Quickstart Guide](https://modelcontextprotocol.io/quickstart/user)\n- Install Claude Desktop: [Download](https://claude.ai/download)\n\n#### Usage with VS Code\n\nAdd the following to your VS Code settings (JSON):\n\n```json\n{\n \"mcp\": {\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"pinelabs_client_id\",\n \"description\": \"Pine Labs Client ID\"\n },\n {\n \"type\": \"promptString\",\n \"id\": \"pinelabs_client_secret\",\n \"description\": \"Pine Labs Client Secret\",\n \"password\": true\n }\n ],\n \"servers\": {\n \"pinelabs\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\",\n \"PINELABS_CLIENT_ID\",\n \"-e\",\n \"PINELABS_CLIENT_SECRET\",\n \"-e\",\n \"PINELABS_ENV=prod\",\n \"pinelabs/mcp:latest\"\n ],\n \"env\": {\n \"PINELABS_CLIENT_ID\": \"${input:pinelabs_client_id}\",\n \"PINELABS_CLIENT_SECRET\": \"${input:pinelabs_client_secret}\"\n }\n }\n }\n }\n}\n```\n\nLearn more about MCP servers in VS Code's [agent mode documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers).\n\n#### Usage with Cursor\n\n```json\n{\n \"mcpServers\": {\n \"pinelabs\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\",\n \"PINELABS_CLIENT_ID\",\n \"-e\",\n \"PINELABS_CLIENT_SECRET\",\n \"-e\",\n \"PINELABS_ENV=prod\",\n \"pinelabs/mcp:latest\"\n ],\n \"env\": {\n \"PINELABS_CLIENT_ID\": \"\",\n \"PINELABS_CLIENT_SECRET\": \"\"\n }\n }\n }\n}\n```\n\nReplace `` and `` with your Pine Labs credentials.\n\n### Build from Docker (Alternative)\n\nClone the repository and build the Docker image locally:\n\n```bash\ngit clone https://github.com/plural-pinelabs/pinelabs-online-mcp.git\ncd pinelabs-online-mcp\ndocker build -t pinelabs-mcp-server:latest .\n```\n\nOnce built, replace `pinelabs/mcp:latest` with `pinelabs-mcp-server:latest` in the configurations above.\n\n### Build from Source\n\nRun the server directly from source without Docker:\n\n```bash\n# Clone the repository\ngit clone https://github.com/plural-pinelabs/pinelabs-online-mcp.git\ncd pinelabs-online-mcp\n\n# Create and activate a virtual environment\npython -m venv .venv\nsource .venv/bin/activate # macOS/Linux\n# .venv\\Scripts\\activate # Windows\n\n# Install dependencies\npip install -r requirements.txt\n\n# Run the server (stdio mode)\npython -m cli.pinelabs_mcp_server.main stdio \\\n --client-id \\\n --client-secret \\\n --env prod\n```\n\nOnce running, configure your MCP client to connect to the local process. Example for VS Code:\n\n```json\n{\n \"mcp\": {\n \"servers\": {\n \"pinelabs\": {\n \"command\": \"python\",\n \"args\": [\n \"-m\",\n \"cli.pinelabs_mcp_server.main\",\n \"stdio\"\n ],\n \"env\": {\n \"PINELABS_CLIENT_ID\": \"\",\n \"PINELABS_CLIENT_SECRET\": \"\",\n \"PINELABS_ENV\": \"prod\"\n }\n }\n }\n }\n}\n```\n\n---\n\n## Configuration\n\n### Environment Variables\n\n| Variable | Required | Default | Description |\n|:---------|:---------|:--------|:------------|\n| `PINELABS_CLIENT_ID` | Yes | -- | Pine Labs client ID for API authentication |\n| `PINELABS_CLIENT_SECRET` | Yes | -- | Pine Labs client secret for API authentication |\n| `PINELABS_ENV` | No | `uat` | Target environment: `uat` or `prod` |\n| `LOG_LEVEL` | No | `INFO` | Log verbosity: `DEBUG`, `INFO`, `WARNING`, `ERROR` |\n| `LOG_FILE` | No | stderr | Path to log output file |\n| `READ_ONLY` | No | `false` | Restrict to read-only tools (disables write operations) |\n| `TOOLSETS` | No | all | Comma-separated list of toolsets to enable |\n\n### Command Line Flags\n\n```\npython -m cli.pinelabs_mcp_server.main [options]\n\nTransports:\n stdio Standard I/O transport (for MCP clients)\n http HTTP transport (for web-based access)\n\nOptions:\n --client-id Pine Labs client ID\n --client-secret Pine Labs client secret\n --env Environment: uat, prod (default: uat)\n --log-file Path to log file\n --log-level Log level: DEBUG, INFO, WARNING, ERROR\n --read-only Only register read-only tools\n --toolsets Comma-separated list of toolsets to enable\n\nHTTP-only options:\n --host Host to bind to (default: 0.0.0.0)\n --port Port to listen on (default: 8000)\n```\n\n---\n\n## Debugging the Server\n\nUse the `--log-level DEBUG` flag and optionally `--log-file` to write detailed logs for troubleshooting:\n\n```bash\npython -m cli.pinelabs_mcp_server.main stdio \\\n --client-id --client-secret \\\n --log-level DEBUG --log-file ./debug.log\n```\n\n---\n\n## FAQ\n\n**Q: Do I need to provide amounts in paisa?**\nA: No. Amounts are specified in rupees (e.g., `500` for INR 500). No conversion to paisa is required.\n\n**Q: What environments are supported?**\nA: The server supports `uat` (default) and `prod` environments. Set via `PINELABS_ENV` or `--env`.\n\n**Q: Can I restrict which tools are available?**\nA: Yes. Use the `--read-only` flag to disable write operations, or use `--toolsets` to enable specific toolsets (e.g., `--toolsets payment_links,orders`).\n\n**Q: Where can I find the full API reference?**\nA: Visit the [Pine Labs Developer Documentation](https://developer.pinelabsonline.com/docs/mcp-server-overview) for the complete API reference.\n\n---\n\n## Keywords\n\nPine Labs, Pine Labs Online, Plural, Plural Online, payment gateway, online payment gateway, checkout gateway, payment checkout, online checkout, hosted checkout, payment page, payments, online payments, digital payments, payment processing, accept payments, collect payments, payment integration, gateway integration, payments API, payment API, checkout API, gateway API, UPI, cards, credit card, debit card, netbanking, wallet, EMI, cardless EMI, subscriptions, recurring payments, orders, order payments, create payment, initiate payment, process payment, payment links, MCP server, Model Context Protocol, AI payment automation, agentic payments, QR code payments, payment orchestration, merchant API, transaction reporting, fintech, SDK\n\n---\n\n## License\n\nThis project is licensed under the Apache 2.0 license. See [LICENSE](https://github.com/plural-pinelabs/pinelabs-online-mcp/blob/main/LICENSE) for the full terms.\n","changelogMarkdown","videoKey","requiredSecretsJson","[\"X_CLIENT_ID\",\"X_CLIENT_SECRET\"]","publishedAt","priceCents","trialDays",0,"categoryDisplayName","Developer Tools","upstream",{"_98":99,"_100":101,"_102":103,"_104":105,"_106":-5},"requiredSecrets",[96,97],"tags",[],"assets",[],"stats",{"_94":81,"_95":81},"ratingAvg","reviewCount","X_CLIENT_ID","X_CLIENT_SECRET","topics",[],"license","Apache-2.0","language","Python","registryName","io.github.plural-pinelabs/pinelabs-online-mcp","homepage","ENV",{"_109":110,"_111":112,"_113":114},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]