# Copperx MCP MCP > Copperx lets your AI agent manage all crypto payments, invoices, and recurring subscriptions directly. Use it to track account balances across different chains, generate instant payment links for products, or list active customer billing cycles without leaving your chat window. ## Overview - **Category:** payment-processing - **Price:** Free - **Tags:** web3-payments, crypto-billing, checkout-links, recurring-revenue, payouts, decentralized-finance ## Description Handling web3 billing used to mean jumping between dashboards, checking multiple blockchain explorers, and manually reconciling every transaction. Now, you can manage payments entirely through conversation. Copperx connects the crypto payment processor directly into your AI workflow, letting your agent handle everything from creating customer records to tracking complex payouts across various currencies. You simply tell your agent what needs paying or checked, and it handles the data retrieval for you. If you're building anything that touches digital revenue—from e-commerce platforms to decentralized autonomous organizations—you need this capability. Connecting Copperx via Vinkius gives your AI client access to a whole suite of payment tools in one place. ## Tools ### create_customer Registers a new user in Copperx, saving their identity details for future payments. ### create_payment_link Generates a unique URL that directs customers to pay for specific products or services. ### get_wallet_balance Checks current crypto balances across multiple supported coins and networks. ### get_payment_details Retrieves deep information on a single payment, including the blockchain transaction hash and fees. ### list_customers Lists all customer accounts registered in Copperx, providing identifiers and contact details. ### list_invoices Retrieves a list of generated invoices, showing amounts, numbers, and payment status. ### list_payment_links Lists all the checkout links you've created, including their pricing data and usage stats. ### list_payments Provides a comprehensive list of payment attempts, showing IDs, amounts, currencies, and status. ### list_payouts Lists all processed payouts, detailing the destination wallet address and settlement status. ### list_subscriptions Shows a full list of current and historical recurring billing plans for your users. ## Prompt Examples **Prompt:** ``` Create a crypto payment link for 'Consulting Service' worth 100 USDC. ``` **Response:** ``` I've created your payment link for 'Consulting Service'. Customers can pay 100 USDC using this URL: [Link]. Would you like me to email this to a customer? ``` **Prompt:** ``` Check my current account balances across all crypto wallets. ``` **Response:** ``` Your total balance is equivalent to $12,450. Breakdown: 10,000 USDC (Polygon), 1.2 ETH (Mainnet), and 500 MATIC. Would you like to see the recent transaction history? ``` **Prompt:** ``` List all active subscriptions and their monthly revenue. ``` **Response:** ``` You have 45 active subscriptions generating approximately 4,500 USDC per month. 5 new subscribers joined this week. Should I pull a detailed report? ``` ## Capabilities ### Manage Customer Accounts The agent creates, retrieves, and lists customer records using identity details like email or name. ### Generate Payment Links It builds unique checkout URLs for specific products or services so customers can pay instantly via crypto. ### Track Financial Balances You can check the current amount of supported cryptocurrencies in a wallet, regardless of the network they live on. ### Review Billing Cycles The system lists all active and past recurring billing plans for your customer base. ### Generate Invoices and Payments It generates new crypto invoices for global customers, tracks existing payments, and lists payout history. ## Use Cases ### Onboarding a New Client A freelance developer needs to set up billing for a new client. They use create_customer first to register the client, then immediately call create_payment_link with the service price, giving the client an instant, trackable payment URL. ### Auditing Monthly Revenue The billing manager needs to know exactly how much money is coming in. They use list_subscriptions and then call list_payments to reconcile active recurring revenue against recent transaction attempts. ### Investigating a Payment Failure A platform notices a payment failed. Instead of checking the blockchain manually, they run get_payment_details on the specific intent ID. This immediately shows if the failure was due to fees, network issues, or customer action. ### Checking Global Payouts A DAO treasurer needs visibility into funds sent out. They use list_payouts to verify that all member disbursements were processed and check the settlement status against their expected ledger entries. ## Benefits - Stop manually checking balances. Use get_wallet_balance to instantly see your total account holdings across multiple networks, all in one command. - Handling new customers is fast. You can create a record with create_customer, ensuring every payment attempt links back to an established user identity. - Need to charge someone for a specific service? Use create_payment_link to build a unique checkout URL instantly, eliminating manual invoicing steps. - Track your recurring revenue without logging into a billing platform. list_subscriptions gives you a clean overview of who is active and when their plan renews. - Audit payouts easily. The list_payouts tool shows every disbursement sent out, detailing the destination wallet address and if it settled successfully. ## How It Works The bottom line is you get real-time financial data and actions without ever opening a payments dashboard. 1. Your AI agent receives a request (e.g., 'Check the revenue'). 2. The MCP sends that request to Copperx, which runs the necessary tool function. 3. Copperx returns clean, actionable data—like current balances or invoice lists—back through your chat window. ## Frequently Asked Questions **How do I check my balance with get_wallet_balance?** You ask your agent, 'What are my current crypto balances?' The tool checks real-time wallet data and gives you a breakdown across all supported coins and networks. **Can list_invoices help me track overdue payments?** Yes. list_invoices provides the invoice numbers, totals, and payment status links for every document generated. You can spot which bills haven't been paid yet. **What is the difference between list_payments and list_payouts?** list_payments tracks all incoming payment intents (the attempt to pay). list_payouts specifically lists funds that were sent out, showing where they went and their settlement status. **How do I generate a unique link using create_payment_link?** You just tell the agent what product it is and how much it costs. The tool resolves that data and spits out a unique, ready-to-use payment URL for your customer. **When should I use the `create_customer` tool, and how does it ensure identity data is valid for payments?** You run `create_customer` when you need to register a new user's details before billing. This function establishes a record using properties like email or name, linking future transactions to that specific customer ID. **If a payment is flagged as failed, what deep transaction data can I retrieve with `get_payment_details`?** The `get_payment_details` tool retrieves highly granular information about the intent. You get access to blockchain transaction hashes, a detailed breakdown of fees, and specific links back to the customer record. **How do I use `list_payment_links` to audit all the checkout URLs that my application has generated?** `list_payment_links` retrieves metadata for every payment URL you've created. This allows you to quickly review pricing configurations, usage statistics, and the full list of active links managed by Copperx. **What critical state information about recurring billing cycles can I get using `list_subscriptions`?** `list_subscriptions` provides a clear view of every subscription. It shows both the plan IDs, current billing cycle status, and whether the account is active or past due. **How do I get a Copperx API Key?** Log in to your Copperx dashboard, navigate to **Settings > API Keys**, and generate a new key. You can use either Test or Live keys depending on your needs. **Which cryptocurrencies are supported?** Copperx supports major assets like USDC, USDT, ETH, and MATIC across multiple chains including Ethereum, Polygon, and Solana. **Can I create recurring subscriptions via chat?** Yes, you can instruct the agent to create payment links or customers that can be tied to subscription plans defined in your Copperx account.