Integration

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.

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in NOWPayments.Built from the 23 NOWPayments tools below, on the connection you add once.

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 Code
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"
Codex (~/.codex/config.toml)
[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"
Cursor, Claude Desktop and other JSON configs
{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect NOWPayments

  1. Create your workspace

    Sign up free. Nothing to install.

  2. 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.

  3. 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.

Popular integrations

Browse the whole catalog