NOWPayments integration
NOWPayments is a crypto payment gateway. Create crypto payments and hosted invoice pages for a fiat or crypto price, check payment status, get minimum amounts and price estimates, list supported coins, read your custody balance, validate payout addresses, list payouts and their status, estimate payout fees, read recurring payment plans and subscriptions, and top up or read customer (sub-partner) balances. Routes that need the short-lived dashboard login token (5-minute JWT) are not exposed: creating and verifying payouts, the payment list, conversions, fiat payouts, creating customers and transfers, and creating or changing plans and email subscriptions. Cancelling scheduled payouts is not exposed either, since such payouts can only be created with that token. Authentication is your NOWPayments API key, sent in the x-api-key header.
Say what should happen.
The workflow builds itself.
What you can do with NOWPayments
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Payment, 3 operations
create_customer_deposit_paymentCreate customer deposit paymentPOSTCreates a payment that tops up one of your customer accounts and returns its deposit address and amount. Track it with get_payment_status.create_paymentCreate paymentPOSTCreates a payment in a given crypto and returns the deposit address and amount, so the customer pays without leaving your site. Track it with get_payment_status or IPN callbacks.get_payment_statusGet payment statusGETReturns a payment's current status and amounts (paid, outcome, hashes). Call it with the same API key that created the payment.
Balance, 2 operations
get_balanceGet balanceGETReturns your custody balance per currency. Each key is a currency ticker holding amount (available) and pendingAmount (still processing).get_customer_balanceGet customer balanceGETReturns the custody balance of one of your customer accounts, per currency (amount and pendingAmount). Only from a whitelisted IP when IP whitelisting is on.
Min amount, 2 operations
get_minimum_payment_amountGet minimum payment amountGETReturns the minimum payment amount for a currency pair (payment currency to your payout currency). currency_from may be a fiat currency; fiat_equivalent adds the minimum in a fiat currency.get_payout_minimum_amountGet payout minimum amountGETReturns the current minimum amount of a payout (withdrawal) in a given coin.
Payout, 2 operations
get_payout_statusGet payout statusGETReturns a payout batch with each of its withdrawals and their status (only FINISHED and REJECTED are final). Call it with the same API key that created the payout.list_payoutsList payoutsGETLists your payouts, filtered by batch, status or date and sorted as asked, one page at a time.
Plan, 2 operations
get_subscription_planGet subscription planGETReturns one recurring payment plan by id, with its price, period and redirect URLs.list_subscription_plansList subscription plansGETLists the recurring payment plans you created, with their price, period and redirect URLs.
Subscription, 2 operations
get_recurring_paymentGet recurring paymentGETReturns one recurring payment (subscription) by id, with its plan, status, subscriber and period end.list_recurring_paymentsList recurring paymentsGETLists the recurring payments (subscriptions) of your plans, filtered by status, plan or active state.
Coin, 1 operation
list_merchant_coinsList merchant coinsGETLists the tickers of the coins you enabled for payments in the coins settings of your NOWPayments account.
Currency, 1 operation
list_available_currenciesList available currenciesGETLists the tickers of every cryptocurrency available for payments with your current setup (btc, eth, usdttrc20...). Set fixed_rate=true to keep only those usable for fixed-rate payments.
Estimate, 1 operation
get_estimated_priceGet estimated priceGETConverts an amount into another currency at the current rate, before fees (for example a fiat price into the crypto to pay). Works for crypto pairs too. The actual payment amount may differ.
Fee, 1 operation
estimate_payout_feeEstimate payout feeGETEstimates the network fee of a payout of a given amount and currency at this moment. The fee is dynamic; the actual one is computed when the payout is processed.
Full currency, 1 operation
list_currency_detailsList currency detailsGETLists every cryptocurrency available for payments with its details (code, name, network, wallet address pattern, whether a memo is needed, logo).
Invoice, 1 operation
create_invoiceCreate invoicePOSTCreates a hosted payment page (invoice) for a fiat price and returns its invoice_url to share with the customer, who picks the coin there unless pay_currency is set.
Invoice payment, 1 operation
create_payment_by_invoiceCreate payment by invoicePOSTCreates a payment for an existing invoice (iid from create_invoice) in a chosen crypto and returns the deposit address and amount, so the customer pays without leaving your site.
Status, 1 operation
get_api_statusGet api statusGETChecks that the NOWPayments API is up. Returns message OK when everything works, otherwise an error. Needs no API key.
Update merchant estimate, 1 operation
update_payment_estimateUpdate payment estimatePOSTReturns the current pay_amount estimate of a payment, and renews it once its expiration_estimate_date has passed (before that the current estimate comes back unchanged).
Validate address, 1 operation
validate_payout_addressValidate payout addressPOSTChecks that a payout address is valid for a currency and can receive funds. Answers OK when valid; an invalid address is refused with code BAD_CREATE_WITHDRAWAL_REQUEST.
Use NOWPayments from Claude Code, Cursor or Codex
Connect NOWPayments in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its NOWPayments operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect NOWPayments
- Create your workspace
Sign up free. Nothing to install.
- Connect NOWPayments once
Add your NOWPayments connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
NOWPayments integration FAQ
What can you do with the NOWPayments integration?
LiveContext exposes 23 operations on NOWPayments, covering payment, balance, min amount and payout.
