Tools

AI agents (MCP)

@axiomis-pay/mcp is a Model Context Protocol server. Connect it to Claude, Cursor or any MCP client and the agent can create invoices and payment links and check whether they are paid. The agent never moves money: a person pays on the Axiomis Pay page and the funds go to your wallet.

Setup

Take a test key (axp_test_…) in the dashboard, Developers. Test mode uses testnets only.

{
  "mcpServers": {
    "axiomis-pay": {
      "command": "npx",
      "args": ["-y", "@axiomis-pay/mcp"],
      "env": { "AXIOMISPAY_API_KEY": "axp_test_..." }
    }
  }
}

Then ask in plain words: “Create a $29 invoice for order 1042 and give me the payment link”, “Has order 1042 been paid?”, “Make a donation link from $5 to $500”.

Tools

Tool	What it does
`create_invoice`	Invoice in USD → payment page URL. The same order id within 30 minutes returns the same invoice
`get_invoice`	Status, amount, received, payment page
`find_invoices_by_order`	All invoices of an order (several if the payer switched networks)
`cancel_invoice`	Close an unpaid invoice; refused once a payment arrived
`create_payment_link`	Link with a fixed or payer-chosen amount
`list_payment_links`	Links with payments and totals
`set_payment_link_active`	Turn a link off or on
`list_assets`	Networks and coins available to payers now

Limits and safety

Variable	Default	Meaning
`AXIOMISPAY_API_KEY`	—	`axp_test_…` or `axp_live_…`
`AXIOMISPAY_ALLOW_LIVE`	`false`	A live key is refused unless this is true
`AXIOMISPAY_MAX_AMOUNT_USD`	`1000`	Upper limit for one invoice or link
`AXIOMISPAY_READ_ONLY`	`false`	Only the get, find and list tools
`AXIOMISPAY_BASE_URL`	`https://pay.axiomis.app/api`	API host

Keep the API key in the client config, not in the chat. An agent can create and cancel invoices with the key it has, so start with a test key and the read-only mode until you trust the setup.