Setup Guide - Hosted MCP Server

Learn how to set up the Pine Labs hosted MCP Server—no infrastructure required.

A ready-to-use MCP Server hosted by Pine Labs, requiring zero infrastructure, with built-in updates and reliable uptime

📋 Prerequisites

Before you begin setting up the Pine Labs Hosted MCP Server, make sure you have the following:

  • An active Pine Labs Merchant Account with API access enabled.
  • API credentials (Client ID and Client Secret) are available from your merchant dashboard.
  • A supported AI Assistant such as Claude Desktop, VS Code, Cursor, or any compatible tool.
  • Node.js version 22 or higher, along with npm and npx installed.
  • A compatible Operating System: macOS, Windows, or Linux.

Installation Steps

Begin the setup process using the steps outlined below.

Step 1: Install Node.js

The Pine Labs Hosted MCP Server requires Node.js with npm and npx. Choose the appropriate installation method based on your operating system.

For Mac
Option 1: Download from Official Website (Recomended)
Option 2: Using Homebrew

Ideal for: Business users seeking AI-driven payment automation without coding.

  1. Go to Node.js Org.
  2. Download the LTS (Long-Term Support) version.
  3. Open the downloaded .pkg installer file.
  4. Follow the on-screen instructions to complete the installation.

For Windows
Option 1: Download from Official Website (Recomended)
Option 2: Using Chocolatey
Option 3: Using Windows Package Manager
  1. Visit Node.js Org.
  2. Download the LTS (Long-Term Support) version for Windows.
  3. Run the downloaded .msi installer.
  4. Follow the installation wizard.
  5. Ensure to check the option "Add to PATH" during setup.

For Linux
Option 1: Using Ubuntu/Debian
Option 2: Using CentOS/RHEL/Fedora

Ideal for: Business users seeking AI-driven payment automation without coding.

  1. sudo apt update
  2. sudo apt install nodejs npm

Step 2: Verify Installation

After installing Node.js, verify that it is installed correctly by checking the versions of node and npm using your terminal or command prompt.

To Verify Installation
  1. node --version
    1. Sample Output: v22.3.0
  2. npm --version
    1. Sample Output: 10.8.1
  3. npx --version
    1. Sample Output: 10.8.1

Step 3: Configure Your AI Tool

Learn how to connect and set up your preferred AI development environment to integrate with Pine Labs Hosted MCP Server for streamlined, API-based automation.

Choose Your AI Tool

The Pine Labs MCP Server is compatible with various AI-powered development environments. Choose the tool that best aligns with your workflow and technical requirements.

Option 1: Claude Desktop (Recommended)
Option 2: Visual Studio Code
Option 3: Cursor

Ideal for: Business users seeking AI-driven payment automation without coding.

  • Simple and intuitive chat-based interface.
  • No technical experience required.
  • Supports automated payment workflows.
  • Follow the Claude Desktop Configuration to get started.

Claude Desktop Configuration

This setup enables AI-powered automation of payment workflows through Claude.

Step 1: Install Claude Desktop

Download and install Claude Desktop for your operating system:

  1. Go to the Claude Desktop website and download the Claude application.

  1. Choose your OS and follow the installation instructions.
  2. Launch Claude Desktop.

Step 2: Access Developer Settings

Open developer settings based on your operating system:

macOS:

  • Navigate to Claude and select Settings.

  • In the Settings menu, navigate to and select the Developer option.

Windows/Linux:

  • Navigate to file and select settings.
  • In the Settings menu, navigate to and select the Developer option.

Step 3: Configure MCP Server

Locate the configuration file by clicking Edit Config File, or access it manually:

OSFile Location
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\\Claude\\claude_desktop_config.json
Linux~/.config/Claude/claude_desktop_config.json

Step 4: Add Pine Labs Configuration

  • Navigate to developer section and Click on Edit Config.

  • Replace the content of the config file with the following block:
JSON
{
  "mcpServers": {
    "pinelabs-sse-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.pinelabs.com/sse",
        "--header",
        "x-business-name:${BUSINESS_NAME}"
      ],
      "env": {
        "BUSINESS_NAME": "merchant_business_name"
      }
    }
  }
}

📘

Note:

  • Replace merchant_business_name with your actual business name in the env object.

Step 5: Apply Changes

  • Save the configuration (config) file.
  • Completely restart Claude Desktop.
    • macOS: ⌘+Q
    • Windows/Linux: Alt+F4
  • Wait for the application to load (about 10-15 seconds).

VS Code Configuration

This setup enables code generation, debugging, and payment automation directly within your IDE.

📘

Note

  • On macOS, move Visual Studio Code to the Applications folder to enable MCP server configuration options.
  • Ensure you're using the latest version of VS Code, as older versions may not fully support MCP integration.
  • If you're using Microsoft Copilot for Microsoft 365 (formerly Copilot for Enterprise) or standard Copilot, make sure that MCP servers are enabled within Copilot settings.

Step 1: Install MCP Extension for VS Code

  1. Open Visual Studio Code
  2. Launch the Command Palette:
    1. macOS: Cmd + Shift + P
    2. Windows/Linux: Ctrl + Shift + P
  3. Search for: MCP: Add Server and select.

  1. Then Select : HTTP( HTTP or Server-Sent Events).


Step 2: Configure Server Details

Configure the server with the below details.

Server Details
  • Server Name: pinelabs-sse-mcp-server.
  • Server URL: https://mcp.pinelabs.com/sse.
  • Description: Pine Labs Payment API Integration.

  1. Enter URL: https://mcp.pinelabs.com/sse and select.

  1. Next select Server Name: pinelabs-sse-mcp-server.

  1. Then choose the settings according to your requirements. You can choose either User Settings or Workspace Settings.

Step 3: Start the MCP Server

  • Press Enter to confirm the configuration.
  • Open the MCP Panel in VS Code.
  • Click "Start Server".
JSON

{
  "mcp": {
    "servers": {
      "pinelabs-mcp-sse-server": {
        "type": "http",
        "url": "https://mcp.pinelabs.com/sse",
        "timeout": 30000,
        "retries": 2,
        "retryDelay": 1000,
        "keepAlive": true,
        "maxConcurrent": 3,
        "headers": {
          "x-business-name": "merchant_business_name"
        }
      }
    }
  }
}

📘

Note:

  • Replace merchant_business_name with your actual business name in the headers object.
  • Confirm that the server status shows green "Connected" indicators.
  • Restart the application, then enable Copilot's Agent Mode in VS Code.

  • Also, make sure that the Pine Labs MCP Server tools are selected and enabled.

Cursor Configuration

Ideal for AI-first developers looking for advanced coding assistance with seamless Pine Labs integration.


Step 1: Install Cursor

Get started by downloading and installing Cursor:

  1. Download the Cursor from Official website.
  2. Login to your Cursor account.
  3. Then navigate to setting and select MCP Tools tab.

  1. Click “Add Custom MCP”, then paste the following JSON into the mcp.json file and save your changes.
JSON

{
  "mcpServers": {
    "Pine": {
      "url": "https://mcp.pinelabs.com/sse",
      "headers": {
        "x-business-name": "merchant_business_name"
      }
    }
  }
}

📘

Note:

  • Replace merchant_business_name with your actual business name in the headers object.

Once the MCP servers are successfully connected, a green indicator icon will appear next to each connected server, confirming the active connection.


You can use the cursor chat to utilize the Pine Labs Online MCP Server.


Next Steps

Once your Pine Labs MCP Server is running:


Ask AI
Assistant
Hourly Limit
0 / 20000 tokens used Resets in: 60m 0s
Order Lifecycle
Refunds
Settlements
Checkout
Dashboard
International Payments
How do I implement webhook notifications for payment status updates, and what's the recommended way to verify webhook authenticity?
How do I integrate Pine Labs payment gateway with my React Native mobile app and what are the required API credentials?
Can I customize the payment UI for card transactions, and what parameters can I pass to modify the checkout experience for my customers?
Assistant