InventPay Server

Give AI agents the ability to manage crypto payments, stores, products, and orders through the Model Context Protocol.

Installation

npm install -g inventpay-mcp

Or run directly with npx:

npx inventpay-mcp

Configuration

Get your API Keys

1. Sign up at inventpay.io
2. Go to Dashboard → Settings
3. Copy your API key (pk_live_...) — used for all operations (payments, invoices, store, products, orders, balances)
4. (Optional) Generate a Withdrawal API key (wk_live_...) — used exclusively for withdrawing funds to external wallets

Claude Desktop

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_KEY is optional. Without it, all tools work except create_withdrawal.

Claude Code

claude mcp add inventpay -- npx -y inventpay-mcp

Then set the environment variables:

export INVENTPAY_API_KEY="your-api-key-here"
export INVENTPAY_WITHDRAWAL_KEY="your-withdrawal-key-here"  # Optional — only for withdrawals

Cursor

Add 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_KEY is optional. Without it, all tools work except create_withdrawal.

Windsurf

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_KEY is optional. Without it, all tools work except create_withdrawal.

Available Tools

Payments

Tool	Description
create_payment	Create a crypto payment with a unique wallet address
create_invoice	Create a multi-currency invoice (customer chooses crypto)
get_payment_status	Check payment status, confirmations, and transaction details

Balances

Tool	Description
get_balances	Get all cryptocurrency balances (available, pending, earned, withdrawn)

Withdrawals

Tool	Description
create_withdrawal	Withdraw funds to an external wallet address
get_withdrawal	Check withdrawal status and transaction hash

Store Management

Tool	Description
create_store	Create a crypto-powered storefront
get_store	Get store details, product count, and order count
update_store	Update store name, description, logo, or visibility

Products

Tool	Description
create_product	Add a digital product with automatic delivery content
list_products	List products with search and pagination
update_product	Update product details, price, or digital content
delete_product	Deactivate a product

Orders

Tool	Description
list_orders	List orders with status filter and pagination
get_order	Get full order details (items, payment, customer)
update_order_status	Update fulfillment status

Analytics

Tool	Description
get_store_analytics	Get order counts, revenue breakdown, and product stats

Example Prompts

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?"

Environment Variables

Variable	Required	Description
INVENTPAY_API_KEY	Yes	Your merchant API key (pk_live_...). Used for all operations: payments, invoices, store, products, orders, balances.
INVENTPAY_WITHDRAWAL_KEY	No	Withdrawal-only key (wk_live_...). Used exclusively for withdrawing funds to external wallets. Cannot be used for any other operation. Generate from Dashboard → Settings → Withdrawal API Key.
INVENTPAY_BASE_URL	No	API base URL (default: https://api.inventpay.io)

License

MIT