CigalPay MCP Server
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CIGALPAY_API_KEY | Yes | Your CigalPay API key from the dashboard. Required to read payments and refunds. Keep it secret. | |
| CIGALPAY_ACCOUNT_ID | Yes | Your CigalPay Account ID from the dashboard. Required to create payment links. | |
| CIGALPAY_NOTIFY_URL | No | Public HTTPS URL that receives signed payment notifications. Needed by create_checkout, unless notify_url is passed per call. | |
| CIGALPAY_RETURN_URL | No | Where customers go after paying. | cigalpay.com |
| CIGALPAY_ALLOW_REFUNDS | No | Set to 1 to enable the create_refund tool. Off by default. | 0 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
CigalPay is a crypto payment gateway. Prices are in USD or EUR; the customer picks the coin (Bitcoin, USDT, Ethereum, Solana...) on the checkout page. Use create_checkout to get a payment link, then get_payment or get_payments_by_order to follow it. A payment is paid only when its status is confirmed or finished. Refunds move money: always confirm the payment and amount with the user first.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| create_checkoutA | Create a payment priced in USD or EUR and return the CigalPay checkout link to send to the customer. The customer chooses the coin on the checkout page; the rate is locked for 30 minutes. Maximum 5,000 per payment. |
| get_paymentB | Status, coin, amounts and transaction of a payment by its id. Paid means status confirmed or finished. |
| get_payments_by_orderC | Every payment created for one of your order references (the order_id of create_checkout). |
| list_active_paymentsA | Payments created on the account that are still waiting for the customer to pay. |
| list_supported_coinsA | The coins CigalPay accepts directly (other coins are converted automatically at checkout). |
| list_refundsB | Refunds of a payment, newest first, with their status. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool has a distinct action scope: create, single-payment lookup by id, lookups by order reference, coin listing, pending listing, and refund listing. The three payment-reading tools (get_payment, get_payments_by_order, list_active_payments) are close in purpose, but the descriptions make the lookup key explicit enough that an agent can pick correctly.
All six tools follow a strict snake_case verb_noun pattern (create_checkout, get_payment, list_supported_coins, etc.) with consistent use of get_ for single lookups and list_ for collections. The only minor quirk is create_checkout naming the outcome 'checkout' rather than 'payment', which is still predictable and readable.
Six tools is tightly scoped to the payment-gateway domain: one create path, three read paths, and two reference-data/list tools. Nothing feels redundant or padded.
Core flow (create checkout, check status, track by order, list pending, list coins) is covered, but there is no way to create or cancel a refund or cancel a payment—only list_refunds exists. These are notable lifecycle gaps that would force an agent to fall back to the web dashboard.