# Plisio — how to use (mcp.ai)

Connect your Plisio account and use 12 tools for payment processing straight from your AI agent. Connect with your own API key. Plisio is a cryptocurrency payment gateway that enables businesses to accept payments in over 15 cryptocurrencies, including Bitcoin, Ethereum, and Litecoin.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_plisio?ms=1787295960000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `plisio_create_invoice`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/plisio`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/plisio/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/plisio/create/invoice` — Tool to create a new cryptocurrency payment invoice with Plisio. Returns transaction ID and invoice URL for payment. For white-label accounts, includes additional fields like wallet hash, QR code, and
  - body: { email?: string, amount?: string, plugin?: string, version?: string, currency: string, language?: string, expire_min?: string, order_name: string, description?: string, callback_url?: string, order_number: string, source_amount?: string, return_existing?: integer, source_currency?: string, fail_invoice_url?: string, allowed_psys_cids?: string, fail_callback_url?: string, redirect_to_invoice?: boolean, success_invoice_url?: string, success_callback_url?: string }
- `POST https://api.mcp.ai/api/plisio/estimate/fee` — Tool to estimate network fee for a withdrawal transaction to specific address(es). Use when calculating transaction costs before creating a withdrawal.
  - body: { amounts: string, fee_plan: string, psys_cid: string, addresses: string }
- `POST https://api.mcp.ai/api/plisio/get/balance/by/currency` — Tool to get the balance for a specific cryptocurrency in your Plisio account. Use when you need to retrieve the balance of a particular crypto asset.
  - body: { psys_cid: string }
- `POST https://api.mcp.ai/api/plisio/get/commission` — Tool to estimate the total cost including network fee and Plisio commission for a transaction. Returns detailed breakdown of commission, fee, and fee plan options for the specified cryptocurrency and 
  - body: { type: string, amounts: string, feePlan?: string, psys_cid: string, addresses: string }
- `POST https://api.mcp.ai/api/plisio/get/currency/rate` — Tool to retrieve list of supported cryptocurrencies with current rates filtered by fiat currency. Use when you need exchange rate information for cryptocurrencies in a specific fiat currency.
  - body: { fiat: string }
- `POST https://api.mcp.ai/api/plisio/get/fee/plans` — Tool to retrieve available fee plans for a given cryptocurrency. Specify a currency symbol like 'BTC', 'ETH' to get fee plan details.
  - body: { currency: string }
- `POST https://api.mcp.ai/api/plisio/get/fee/plans2` — Tool to get available fee plans for a specific cryptocurrency. Returns fee values and configuration like gas limits for Ethereum-based coins or confirmation targets for Bitcoin. Use when you need to d
  - body: { psys_cid: string }
- `POST https://api.mcp.ai/api/plisio/get/invoice` — Tool to retrieve detailed information about a specific invoice by its ID. Use when you need to check invoice status, payment details, or transaction information.
  - body: { id: string }
- `POST https://api.mcp.ai/api/plisio/get/invoice/email` — Tool to retrieve invoice details by email ID. Use when you need to fetch detailed information about a specific invoice using the invoice ID and payer's email address.
  - body: { id: string, email: string }
- `POST https://api.mcp.ai/api/plisio/get/shop` — Tool to retrieve shop information by API key. Returns details about the shop associated with the current API credentials.
- `POST https://api.mcp.ai/api/plisio/get/transactions` — Tool to retrieve a list of transactions and invoices. Use after authenticating with your API key to fetch historical operations with optional filters and pagination. Example: GetTransactions(status='p
  - body: { to?: integer, page?: integer, type?: string, limit?: integer, since?: integer, status?: string, currency?: string, order_id?: string, order_name?: string }
- `POST https://api.mcp.ai/api/plisio/list/currencies` — Tool to retrieve a list of supported cryptocurrencies with their rates and information. Use after API credentials are configured to get current exchange rates, commission percentages, and operational 

## Example prompts
- "What can I do in Plisio?"
- "Show me a summary of my Plisio account"

## More
- Page: https://mcp.ai/plisio
- Agent spec (llms.txt): https://mcp.ai/plisio/llms.txt
- Postman collection: https://mcp.ai/plisio/postman.json
