Allows creating and managing Bitcoin payments on the InventPay platform, including generating unique wallet addresses, checking payment status, and handling invoices.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@InventPay MCP Server Create a new store called 'Digital Downloads' and add a product for my e-book at $9.99"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Give AI agents the ability to manage crypto payments, stores, products, and orders through the Model Context Protocol.
npm install -g inventpay-mcpOr run directly with npx:
npx inventpay-mcpRelated MCP server: MidPay MCP Server
Sign up at inventpay.io
Go to Dashboard → Settings
Copy your API key (pk_live_...) — used for all operations (payments, invoices, store, products, orders, balances)
(Optional) Generate a Withdrawal API key (wk_live_...) — used exclusively for withdrawing funds to external wallets
Add to your claude_desktop_config.json:
{
"mcpServers": {
"inventpay": {
"command": "npx",
"args": ["-y", "inventpay-mcp"],
"env": {
"INVENTPAY_API_KEY": "your-api-key-here",
"INVENTPAY_WITHDRAWAL_KEY": "your-withdrawal-key-here"
}
}
}
}
INVENTPAY_WITHDRAWAL_KEYis optional. Without it, all tools work exceptcreate_withdrawal.
claude mcp add inventpay -- npx -y inventpay-mcpThen set the environment variables:
export INVENTPAY_API_KEY="your-api-key-here"
export INVENTPAY_WITHDRAWAL_KEY="your-withdrawal-key-here" # Optional — only for withdrawalsAdd to your Cursor MCP settings (.cursor/mcp.json):
{
"mcpServers": {
"inventpay": {
"command": "npx",
"args": ["-y", "inventpay-mcp"],
"env": {
"INVENTPAY_API_KEY": "your-api-key-here",
"INVENTPAY_WITHDRAWAL_KEY": "your-withdrawal-key-here"
}
}
}
}
INVENTPAY_WITHDRAWAL_KEYis optional. Without it, all tools work exceptcreate_withdrawal.
Add to your Windsurf MCP config:
{
"mcpServers": {
"inventpay": {
"command": "npx",
"args": ["-y", "inventpay-mcp"],
"env": {
"INVENTPAY_API_KEY": "your-api-key-here",
"INVENTPAY_WITHDRAWAL_KEY": "your-withdrawal-key-here"
}
}
}
}
INVENTPAY_WITHDRAWAL_KEYis optional. Without it, all tools work exceptcreate_withdrawal.
Tool | Description |
| Create a crypto payment with a unique wallet address |
| Create a multi-currency invoice (customer chooses crypto) |
| Check payment status, confirmations, and transaction details |
Tool | Description |
| Get all cryptocurrency balances (available, pending, earned, withdrawn) |
Tool | Description |
| Withdraw funds to an external wallet address |
| Check withdrawal status and transaction hash |
Tool | Description |
| Create a crypto-powered storefront |
| Get store details, product count, and order count |
| Update store name, description, logo, or visibility |
Tool | Description |
| Add a digital product with automatic delivery content |
| List products with search and pagination |
| Update product details, price, or digital content |
| Deactivate a product |
Tool | Description |
| List orders with status filter and pagination |
| Get full order details (items, payment, customer) |
| Update fulfillment status |
Tool | Description |
| Get order counts, revenue breakdown, and product stats |
Once connected, you can ask your AI agent things like:
"Create a new store called 'Digital Downloads' and add a product for my e-book at $9.99"
"Show me all my pending orders"
"What's my current ETH balance?"
"Create a payment for $50 in Bitcoin"
"How much revenue has my store generated?"
Variable | Required | Description |
| Yes | Your merchant API key ( |
| No | Withdrawal-only key ( |
| No | API base URL (default: |
MIT
Upload unique keys/codes to a product's key pool. Each customer gets one unique key on purchase (FIFO). Use this for license keys, activation codes, gift cards, etc.
Inputs: keys (required), productId (required), label.
Create a multi-currency invoice. The customer can choose which cryptocurrency to pay with. Returns an invoice URL.
Inputs: amount (required), orderId, callbackUrl, description, +2 more.
Create a crypto payment. Returns a unique wallet address, QR code, and invoice URL for the customer to pay.
Inputs: amount (required), currency (required), orderId, callbackUrl, +3 more.
Add a digital product to your store. Products are priced in USDT and auto-converted to crypto at checkout. Attach digitalContent for automatic delivery after payment.
Inputs: name (required), price (required), stock, images, +6 more.
Create a new merchant storefront. Each merchant gets one store with a unique URL slug. Customers can browse and purchase digital products with crypto.
Inputs: name (required), logo, banner, settings, +1 more.
Create a withdrawal request to send funds to an external wallet address. Requires INVENTPAY_WITHDRAWAL_KEY to be configured (a separate withdrawal API key generated from Dashboard → Settings).
Inputs: amount (required), currency (required), destinationAddress (required), description.
Deactivate a product from your store. Products with existing orders are soft-deleted (hidden, not removed).
Inputs: id (required).
Get all cryptocurrency balances for your merchant account. Shows available, pending, total earned, and total withdrawn for each currency.
Inputs: no named parameters.
Get key pool statistics for a product: available, assigned, revoked, and total counts.
Inputs: productId (required).
Get full details of a specific order including items, payment status, customer info, and timestamps.
Inputs: id (required).
Check the current status of a payment or invoice. Returns status, amount, confirmations, and transaction details.
Inputs: paymentId (required).
Get your store details including name, slug, URL, product count, and order count.
Inputs: no named parameters.
Get store analytics: total orders, revenue breakdown by status, product count, and recent order activity.
Inputs: no named parameters.
Check the status of a withdrawal request. Returns status, amount, transaction hash, and processing details.
Inputs: withdrawalId (required).
List all orders for your store with optional status filter and pagination.
Inputs: page, limit, status.
List keys in a product's key pool with status filter and pagination.
Inputs: productId (required), page, limit, status.
List all products in your store with optional search and pagination.
Inputs: page, limit, search.
Update the fulfillment status of an order. Valid transitions: PAID→PROCESSING, PROCESSING→SHIPPED/COMPLETED, SHIPPED→COMPLETED, COMPLETED→REFUNDED. Digital orders auto-transition to COMPLETED.
Inputs: id (required), status (required), notes.
Update a product in your store. Only provided fields are changed. Updating the name regenerates the slug.
Inputs: id (required), name, price, stock, +8 more.
Update your store details. Only provided fields are changed.
Inputs: logo, name, banner, isActive, +2 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 20 tools
Most tools target distinct resources and actions. Slight overlap exists between get_store and get_store_analytics (both show order/product counts) and between create_payment and create_invoice, but descriptions clarify their different use cases.
All tool names follow a consistent verb_noun pattern with snake_case: get, create, update, delete, list, add. Resources are singular for single-item operations and plural for list operations, with only minor naming variance like get_key_pool_stats.
With 20 tools, the count is higher than the ideal 3-15 range but appropriate for the broad merchant platform scope covering stores, products, keys, payments, withdrawals, orders, and analytics. Each tool has a distinct purpose, so it does not feel bloated.
The tool surface covers core lifecycle operations for stores, products, keys, payments, withdrawals, and orders. Minor gaps exist (e.g., no store deletion, no key revocation, no payment cancellation), but these are typically not required for merchant operations and can be worked around.
The independent agent-commerce protocol for AI-agent checkout on any online store.
Sell to people and AI agents: create products, a storefront, and USDC payment links from chat.
Marketplace and payment rail for AI agents: list, buy and settle with signed receipts.
Multi-seller shopping for AI agents. Settle via Stripe MPP or x402 USDC on Base. Hosted.
