PayPls

Provides an MCP interface to manage BTC and USDC payments via PayPls, including balances, transfers with approval, receive addresses, and transaction tracking.

typescript

0

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "n8m8-paypls-mcp": {
      "command": "npx",
      "args": [
        "@paypls/mcp-server"
      ],
      "env": {
        "PAYPLS_TOKEN": "YOUR_TOKEN_HERE",
        "PAYPLS_API_URL": "https://api.paypls.io"
      }
    }
  }
}

You can run a PayPls MCP Server to let AI assistants manage Bitcoin and USDC payments. This MCP interface exposes actions like checking balances, sending funds with human approval, generating receive addresses, listing buckets, and tracking transaction status, while giving you control over approval flows and bucket isolation.

How to use

Use an MCP client to interact with the PayPls MCP Server. You can ask the AI to check balances, initiate payments that require human approval, generate receive addresses, list your wallet buckets, and monitor the status of transactions. When a transaction exceeds your auto-approve threshold, the system will prompt for explicit human approval, with a justification logged for auditing. Separate wallets (buckets) help you limit agent access to specific funds.

How to install

Prerequisites: Ensure you have Node.js installed on your system. You can verify by running node -v and npm -v.

Install the MCP server globally so you can run it from anywhere.

npm install -g @paypls/mcp-server

Or run directly with npx to start using the server without a global install.

npx @paypls/mcp-server

Configuration

Prepare your PayPls API token and connect the MCP server to the PayPls backend. You will need to supply the API token in your environment variables.

Configuration details

Get your API token from PayPls and set up environment variables in a .env file or your runtime environment.

# Required: Your PayPls API token
PAYPLS_TOKEN=your_token_here

# Optional: API URL (defaults to https://api.paypls.io)
PAYPLS_API_URL=https://api.paypls.io

Claude Desktop setup

Add the PayPls MCP server to your Claude Desktop configuration. You can run the MCP server via npx or install it globally and reference the binary.

{
  "mcpServers": {
    "paypls": {
      "command": "npx",
      "args": ["@paypls/mcp-server"],
      "env": {
        "PAYPLS_TOKEN": "your_token_here"
      }
    }
  }
}

Or if installed globally

If you install the MCP server globally, reference the global binary in your Claude Desktop configuration.

{
  "mcpServers": {
    "paypls": {
      "command": "paypls-mcp",
      "env": {
        "PAYPLS_TOKEN": "your_token_here"
      }
    }
  }
}

Available tools

wallet_balance

Check BTC or USDC balance for a specific wallet bucket.

wallet_list_buckets

List all wallet buckets with their balances.

wallet_send_btc

Send Bitcoin to a specified address.

wallet_send_usdc

Send USDC to a specified address.

wallet_receive

Generate a receive address for funds.

wallet_tx_status

Query the status of a transaction.