# Poof — how to use (mcp.ai)

Connect your Poof account and use 11 tools for payment processing straight from your AI agent. Connect with your own API key. Empowering millions of digital businesses & creators with payments from crypto to fiat.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_poof?ms=1787293440000`
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. `poof_check_balance`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/poof`
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/poof/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/poof/check/balance` — Tool to check the balance of a cryptocurrency wallet. Use when you need to retrieve the current balance for a specified blockchain wallet address.
  - body: { crypto: string }
- `POST https://api.mcp.ai/api/poof/create/checkout` — Tool to create a checkout session for fiat payments. Use when you need to generate a payment link for customers to complete their purchase through the Poof payment infrastructure.
  - body: { amount: string, fields?: string[], default?: object, metadata?: object, redirect?: string, username: string, product_id?: string, success_url?: string, disable_payments?: string[], product_quantity?: string, instant_payment_notification?: string }
- `POST https://api.mcp.ai/api/poof/create/deposit/address` — Tool to create a deposit address for receiving cryptocurrency payments. Generates a unique blockchain address to accept incoming crypto deposits. Use when you need to create a payment address for a cu
  - body: { amount: string, crypto: string, currency: string, metadata?: object }
- `POST https://api.mcp.ai/api/poof/create/fiat/charge` — Tool to create a fiat currency charge through Poof's payment gateway integration. Use when initiating a one-time fiat payment collection via PayPal, Stripe, Square, or other supported gateways.
  - body: { amount: string, payment: string, currency: string, success_url: string, redirect_url: string }
- `POST https://api.mcp.ai/api/poof/create/fiat/invoice` — Create a fiat currency invoice for payment collection. Generates an invoice for collecting payments in traditional currencies via payment processors like PayPal, Stripe, Square, Cash App, etc. Returns
  - body: { amount: string, payment: string, currency: string, success_url: string, redirect_url: string }
- `POST https://api.mcp.ai/api/poof/create/payment/link` — Tool to create a payment link (invoice) for cryptocurrency payments. Use when you need to generate a shareable payment URL for collecting crypto payments from customers.
  - body: { amount: string, crypto: string, metadata: object }
- `POST https://api.mcp.ai/api/poof/create/webhook` — Tool to create a webhook subscription for receiving payment event notifications. Use when you need to set up real-time notifications for transaction status changes and other payment events.
  - body: { url: string }
- `POST https://api.mcp.ai/api/poof/fetch/gas/price` — Tool to fetch current gas prices for blockchain transactions. Returns gas price estimates for Ethereum, Avalanche, Polygon, and other supported EVM chains across different priority levels (slow, stand
  - body: { crypto: string }
- `POST https://api.mcp.ai/api/poof/fetch/price` — Tool to fetch current cryptocurrency prices for supported tokens. Use when you need real-time price data for cryptocurrencies and tokens.
  - body: { crypto: string }
- `POST https://api.mcp.ai/api/poof/fetch/smart/contracts` — Tool to fetch all supported ERC-20 smart contracts across Ethereum, Avalanche, and Polygon networks. Use when you need to retrieve available token contracts and their details for blockchain operations
- `POST https://api.mcp.ai/api/poof/send/payout` — Tool to send a cryptocurrency payout transaction from your wallet to an external address. Use when you need to transfer crypto on supported blockchains.
  - body: { amount: number, crypto: string, address: string }

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

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