Integration

Copperx integration

Copperx is a crypto payment gateway (USDC, USDT, ETH, SOL and other tokens on Ethereum, Polygon, Solana, Base, Arbitrum, Optimism, BNB Chain and Tron). With it an agent can manage customers, products, prices, coupons and tax rates, create hosted checkout sessions and payment links, issue, finalize, send, void or mark paid invoices, cancel or resume crypto subscriptions, list on-chain transactions, read supported chains, assets and currency prices, and manage webhook endpoints. Changing withdrawal (payout) addresses, branding, team members and invitations, file uploads, partner onboarding, checkout auto-recovery, spreadsheet exports and webhook secret regeneration are left to the Copperx dashboard and not exposed. Authentication is a Copperx API key (Dashboard, Developer, API Keys) sent as a Bearer token; this connection calls the production host api.copperx.io, so use a live key (test keys belong to api.copperx.dev).

Connect Copperx How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

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

What you can do with Copperx

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.

Invoice, 11 operations

create_invoiceCreate invoicePOSTCreates a draft invoice for a customer (customerId) with lineItems, due date and payment settings. Nothing is sent: use finalize_invoice or send_invoice next. Returns the invoice with its id and url.
delete_invoiceDelete invoiceDELETEDeletes a draft invoice. An invoice that is no longer a draft cannot be deleted: void it with void_invoice instead.
duplicate_invoiceDuplicate invoicePOSTCreates a new draft invoice copied from this invoice. Returns the new invoice with its id.
finalize_invoiceFinalize invoicePOSTFinalizes a draft invoice so it becomes open and payable at its url. Does not email the customer (send_invoice does). Returns the invoice.
get_invoiceGet invoiceGETReturns an invoice: status, total, subTotal, currency, customer, line items, due date, invoiceNumber, url (payment page), invoicePdfUrl and payment intent.
list_invoicesList invoicesGETLists invoices, filtered by status (draft, open, paid, void, uncollectible), customer, subscription or due date, with totals and customer. Paginated with page and limit.
mark_invoice_paidMark invoice paidPOSTMarks an open invoice as paid (payment received outside Copperx). No funds move; returns the invoice with status paid.
mark_invoice_uncollectibleMark invoice uncollectiblePOSTMarks an invoice as uncollectible. A paid invoice cannot be marked uncollectible. Returns the invoice.
send_invoiceSend invoicePOSTEmails the invoice to the customer (and cc addresses), finalizing it first if it is a draft, now or at finalizeScheduleAt. A real email is sent. Returns the invoice.
update_invoiceUpdate invoicePUTUpdates a draft invoice: description, custom fields, due date, footer, metadata, line items, payment settings and tax rates. Returns the invoice.
void_invoiceVoid invoicePOSTVoids an invoice so it can no longer be paid. A paid invoice cannot be voided. Returns the invoice.

Coupon, 7 operations

archive_couponArchive couponPOSTArchives a coupon so it can no longer be applied. Returns the coupon with isArchived and archivedAt.
create_couponCreate couponPOSTCreates a coupon (percentOff or amountOff) with at least one customer-facing promotion code in promotionCodeData. Returns the coupon with its id and promotionCodes.
disable_couponDisable couponPOSTDisables a coupon (isEnable false) so it can no longer be applied until enable_coupon. Returns the coupon.
enable_couponEnable couponPOSTEnables a disabled coupon (isEnable true) so customers can apply it again. Returns the coupon.
get_couponGet couponGETReturns a coupon: name, percentOff or amountOff, currency, maxRedemptions, redeemBy, timesRedeemed, promotion codes and status.
list_couponsList couponsGETLists coupons, filtered by isEnable, isArchived or searchText, with their promotion codes, discount, redemptions and status. Paginated with page and limit.
update_couponUpdate couponPUTUpdates a coupon's name, maxRedemptions, redeemBy, metadata and isEnable. name is required: read the coupon with get_coupon and send its current name if unchanged. The discount cannot be changed.

Payment link, 7 operations

activate_payment_linkActivate payment linkPUTActivates a payment link so its url accepts payments again. Returns the link.
create_payment_linkCreate payment linkPOSTCreates a reusable crypto payment link (fixed amount or customer-chosen) and returns it with its id and url to share. type, title, tags, the five *Collection flags, submitType and afterCompletion are required.
deactivate_payment_linkDeactivate payment linkPUTDeactivates a payment link so its url stops accepting payments until activate_payment_link. Returns the link.
delete_payment_linkDelete payment linkDELETEPermanently deletes a payment link; its url stops accepting payments.
get_payment_linkGet payment linkGETReturns a payment link: title, type, amount, currencies, chains, collection flags, after-completion settings, isActive and url.
list_payment_linksList payment linksGETLists payment links, filtered by isActive, with title, amount, currencies, url and settings. Paginated with page and limit.
update_payment_linkUpdate payment linkPUTReplaces a payment link's settings. Every required field must be sent again: read the link with get_payment_link and send its current values with your change. Returns the link.

Product, 7 operations

activate_productActivate productPUTActivates a product. Returns the product.
create_productCreate productPOSTCreates a product (name and defaultPriceData required) with its default price. Returns the product with its id and defaultPriceId.
deactivate_productDeactivate productPUTDeactivates a product. Returns the product.
delete_productDelete productDELETEPermanently deletes a product.
get_productGet productGETReturns a product: name, description, images, unitLabel, url, metadata, isActive and default price.
list_productsList productsGETLists products, filtered by isActive, url, price interval or price currency, with name, images and default price. Paginated with page and limit.
update_productUpdate productPUTUpdates a product. name and defaultPriceId are required: read the product with get_product and send their current values if unchanged. Returns the product.

Tax rate, 6 operations

activate_tax_rateActivate tax ratePUTActivates a tax rate. Returns the tax rate.
create_tax_rateCreate tax ratePOSTCreates a tax rate (name and percentage required). Returns it with its id, usable in taxRateIds of invoices, line items and checkout sessions.
deactivate_tax_rateDeactivate tax ratePUTDeactivates a tax rate. Returns the tax rate.
get_tax_rateGet tax rateGETReturns a tax rate: name, description, country, percentage, metadata and isActive.
list_tax_ratesList tax ratesGETLists tax rates, filtered by isActive, with name, percentage and country. Paginated with page and limit.
update_tax_rateUpdate tax ratePUTUpdates a tax rate's name, description, country, metadata and isActive; the percentage cannot be changed. name is required: send the current name if unchanged.

Webhook endpoint, 6 operations

create_webhook_endpointCreate webhook endpointPOSTCreates a webhook endpoint: Copperx will POST the chosen events to url. The signing secret is not returned here: read it in the Copperx dashboard settings to verify the x-webhook-signature header.
delete_webhook_endpointDelete webhook endpointDELETEDeletes a webhook endpoint; Copperx stops sending events to it.
get_webhook_endpointGet webhook endpointGETReturns a webhook endpoint: url, description, isDisabled and enabled events. The signing secret is not returned: it is in the Copperx dashboard settings.
list_webhook_endpointsList webhook endpointsGETLists webhook endpoints, filtered by isDisabled, with url, description and enabled events. The signing secret is not returned: it is in the Copperx dashboard settings.
test_webhook_endpointTest webhook endpointPOSTSends a test event to a webhook endpoint's url. Returns a message and statusCode.
update_webhook_endpointUpdate webhook endpointPUTUpdates a webhook endpoint. description, url and enabledEvents are required: read it with get_webhook_endpoint and send current values with your change. Returns the endpoint.

Customer, 5 operations

create_customerCreate customerPOSTCreates a customer (email required) with optional name, phone, organization, billing and shipping address, tax ids and metadata. Returns the customer with its id.
delete_customerDelete customerDELETEPermanently deletes a customer. Returns a message and statusCode.
get_customerGet customerGETReturns a customer: name, email, phone, organization, address, shipping, tax ids, customerNumber and metadata (personal data).
list_customersList customersGETLists customers, filtered by email or customerReferenceId, with name, email, phone, addresses and tax ids (personal data). Paginated with page and limit.
update_customerUpdate customerPUTUpdates a customer's name, email, phone, organization, address, shipping, tax ids and metadata. email is required: read the customer with get_customer and send its current email if unchanged.

Subscription, 5 operations

cancel_subscriptionCancel subscriptionPOSTSchedules a subscription to cancel at the end of the current period (it stays active until then; resume_subscription undoes it). Returns the subscription.
end_subscriptionEnd subscriptionPOSTEnds a subscription immediately, with no refund. Irreversible (unlike cancel_subscription, which waits for the period end). Returns the subscription.
get_subscriptionGet subscriptionGETReturns a subscription: status, currency, interval, items, customer, default payment method, current period and cancellation details.
list_subscriptionsList subscriptionsGETLists crypto subscriptions, filtered by status, customer, currency, price, product, clientReferenceId or start and end dates. Paginated with page and limit.
resume_subscriptionResume subscriptionPOSTResumes a subscription that was scheduled to cancel at the period end with cancel_subscription. Returns the subscription.

Price, 4 operations

create_priceCreate pricePOSTCreates a price (currency and type required) for an existing productId, or with productData to create the product too. Returns the price with its id, for lineItems.
get_priceGet priceGETReturns a price: type, currency, unitAmount, interval, intervalCount, product, nickname, metadata and isActive.
list_pricesList pricesGETLists prices, filtered by isActive, type (one_time, recurring, streaming) or productId, with amount, currency and interval. Paginated with page and limit.
update_priceUpdate pricePUTUpdates a price's nickname, metadata and isActive; the amount and currency cannot be changed. Leave a field out to keep it. Returns the price.

Session, 3 operations

create_checkout_sessionCreate checkout sessionPOSTCreates a hosted crypto checkout session (one payment or a subscription) and returns it with url, the page to send the customer to. Needs successUrl and lineItems. Create one per payment attempt; expires after 1 hour by default.
get_checkout_sessionGet checkout sessionGETReturns a checkout session: mode, amounts, currency, status (open, complete, incomplete, expired), paymentStatus (unpaid, paid), customer, line items, payment intent and url.
list_checkout_sessionsList checkout sessionsGETLists checkout sessions, filtered by payment link, subscription, invoice, customer, coupon, mode, status or paymentStatus. Paginated with page and limit.

Asset, 2 operations

get_assetGet assetGETReturns one supported crypto asset (token) by id: name, chainId, contract address, currency, symbol and decimals.
list_assetsList assetsGETLists the crypto assets (tokens) Copperx supports: name, chainId, contract address, currency, symbol and decimals. Paginated with page and limit.

Chain, 2 operations

get_chainGet chainGETReturns one supported blockchain by numeric chain id (for example 137 for Polygon), with its assets, currency, block explorer and testnet flag.
list_chainsList chainsGETLists the blockchains Copperx supports, each with its assets, currency, block explorer and testnet flag. Use the numeric id as chainId in payment settings.

Checkout session, 2 operations

complete_partial_checkout_sessionComplete partial checkout sessionPOSTMarks a checkout session whose customer paid less than the total as complete, accepting the partial payment. Irreversible; returns the updated checkout session.
get_checkout_session_completionGet checkout session completionGETReturns only whether a checkout session is completed: completed, status, transactionHash of the payment and updatedAt.

User, 2 operations

get_current_userGet current userGETReturns the user the API key belongs to: name, email, role, status and organization. Contains personal data of that user.
list_usersList usersGETLists the team members of the organization: name, email, phone, role and status (personal data).

Withdrawal address, 2 operations

get_withdrawal_addressGet withdrawal addressGETReturns one withdrawal (payout) address: name, address, chainId and isDefault.
list_withdrawal_addressesList withdrawal addressesGETLists the organization's withdrawal (payout) addresses: name, address, chainId and isDefault.

Currency price, 1 operation

get_currency_pricesGet currency pricesGETReturns current Copperx prices of crypto currencies (price, currency, coingeckoId) quoted in the currency given.

Invoice setting, 1 operation

get_invoice_settingsGet invoice settingsGETReturns the organization's invoice settings.

Organization, 1 operation

get_organizationGet organizationGETReturns the Copperx organization of the API key: name, business details, branding and settings.

Payment, 1 operation

mark_payment_refundedMark payment refundedPOSTRecords a payment as refunded, with an optional comment. It only changes the record: no crypto is sent back by this call. Returns the payment intent.

Payment receipt, 1 operation

send_payment_receiptSend payment receiptPOSTEmails the payment receipt of a payment intent to the customer. A real email is sent. Returns the receipt with receiptNumber and uri.

Payment setting, 1 operation

get_payment_settingsGet payment settingsGETReturns the organization's payment settings: accepted chains and currencies and payout configuration.

Transaction, 1 operation

list_transactionsList transactionsGETLists on-chain transactions of the organization, filtered by subscription, payment intent or type (incoming, outgoing, event, transfer): hash, addresses, amount and asset.

Use Copperx from Claude Code, Cursor or Codex

Connect Copperx in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Copperx 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 Copperx

Create your workspace
Sign up free. Nothing to install.
Connect Copperx once
Add your Copperx 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.