CigalPay MCP server

Let Claude, Cursor, VS Code and other AI assistants use your CigalPay account: create crypto payment links, check whether a payment arrived, and follow refunds, by asking in plain language.

"Create a 49 EUR payment link for invoice 1042, logo design." "Has the payment for order 1042 been confirmed?"

Prices are in USD or EUR. Your customer picks the coin on the CigalPay checkout (Bitcoin, USDT on Tron, Ethereum, Solana, Litecoin and more), with the rate locked for 30 minutes.

Tools

Tool	What it does
create_checkout	Create a payment priced in USD or EUR and return the checkout link (up to 5,000 per payment)
get_payment	Status, coin and amounts of a payment. Paid means confirmed or finished
get_payments_by_order	Every payment created for one of your order references
list_active_payments	Payments still waiting for the customer
list_supported_coins	Coins accepted directly
list_refunds	Refunds of a payment and their status
create_refund	Refund a payment in crypto. Off by default: set CIGALPAY_ALLOW_REFUNDS=1

create_refund moves money out of your CigalPay balance, so it is only available when you turn it on, and it is marked as destructive so your assistant asks before using it.

Setup

Get your Account ID and API key in the CigalPay dashboard, Settings → API credentials. Node.js 18 or later is needed.

Variable
CIGALPAY_ACCOUNT_ID	Required to create payment links
CIGALPAY_API_KEY	Required to read payments and refunds. Keep it secret
CIGALPAY_NOTIFY_URL	Public HTTPS URL that receives signed payment notifications. Needed by create_checkout, unless you pass notify_url each time
CIGALPAY_RETURN_URL	Where customers go after paying (default: cigalpay.com)
CIGALPAY_ALLOW_REFUNDS	1 to enable create_refund

Claude Code

claude mcp add cigalpay \
  -e CIGALPAY_ACCOUNT_ID=your-account-id \
  -e CIGALPAY_API_KEY=your-api-key \
  -e CIGALPAY_NOTIFY_URL=https://your-site.com/cigalpay/notify \
  -- npx -y cigalpay-mcp

Claude Desktop, Cursor, VS Code and others

Add to the client's MCP configuration (claude_desktop_config.json, .cursor/mcp.json, ...):

{
  "mcpServers": {
    "cigalpay": {
      "command": "npx",
      "args": ["-y", "cigalpay-mcp"],
      "env": {
        "CIGALPAY_ACCOUNT_ID": "your-account-id",
        "CIGALPAY_API_KEY": "your-api-key",
        "CIGALPAY_NOTIFY_URL": "https://your-site.com/cigalpay/notify"
      }
    }
  }
}

Payment notifications

CigalPay sends a signed notification to your notify URL when a payment's status changes. Check the x-cigalpay-sig signature before trusting it, with the JavaScript SDK (CigalPay.verifyWebhook) or the PHP SDK. See the developer docs.

Release

Bump the version in package.json, server.json (twice) and CHANGELOG.md, then push a tag vX.Y.Z. GitHub Actions stages the package on npm; approve it on npmjs.com, then run the MCP Registry workflow.

License

MIT