# Getpaid MCP for AI Agents AI Agent Connect > Getpaid. Manage your billing, track payments, and initiate checkouts via AI agents with Getpaid.io. This Connector connects your Getpaid account to any MCP-compatible client so you can handle global transactions, manage customer records, and process refunds through a simple chat interface instead of jumping between tabs. ## Overview - **Category:** finance-accounting - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_NStWBhlWLe3LGjGgcASux6Oxf89Ujmua169DHJzO/ai-agent-connect - **Tags:** saas-billing, payment-gateway, checkout-automation, transaction-tracking, invoicing ## Description Getpaid lets you bring your entire billing operation into your AI chat. Instead of manually digging through rows of data to find a specific invoice or checking if a customer's payment actually cleared, you can just ask your agent to do it for you. It handles the heavy lifting of fetching customer metadata, pulling subscription lists, and monitoring your revenue flow in real-time. When you need to send a new payment link, you don't have to go find the right button; just tell the agent to create a checkout session. It's one of the easiest ways to keep your financial data accurate without the manual overhead of constant context switching. By adding this to your Vinkius catalog, you turn your AI into a functional finance assistant that actually knows your billing history. You get a direct line to your Getpaid account, making it way easier to keep your SaaS or marketplace running smoothly without the constant friction of manual data entry. You can quickly verify a transaction, issue a refund, or pull a list of active plans to see your growth trends. This means you can spend less time auditing logs and more time actually scaling your operations. It puts the power of your payment gateway directly into your chat interface, so you can focus on your business instead of your dashboard. ## Tools ### verify_api_connection Checks if your AI client is properly linked to your Getpaid account. This ensures your agent has the right permissions to see your data. ### create_checkout_session Generates a new checkout session and returns a secure payment link for your customers. It makes it easy to send payment requests during a live conversation. ### get_account_details Pulls your Getpaid account identity and basic configuration info. This helps your agent understand your account setup. ### get_checkout_status Checks the current progress and status of a specific checkout session. Use this to see if a customer has completed their payment yet. ### get_customer_details Retrieves specific metadata and profile information for a single customer. This is useful for looking up billing history during a support call. ### get_payment_details Fetches the full metadata and status for a specific payment record. It gives you a clear view of every transaction in your system. ### list_billing_customers Pulls a full list of all customers currently in your billing database. This helps you keep track of your entire user base. ### list_billing_invoices Lists all generated invoices to help you track historical billing. You can use this to see what was billed and when. ### list_billing_payments Retrieves a list of all processed payments for revenue tracking. It gives a clear overview of your incoming cash flow. ### list_billing_subscriptions Lists all recurring billing plans to help you monitor subscription health. This is great for spotting churn or growth. ### list_payment_webhooks Shows all your configured webhooks to ensure your system notifications are active. Use this to verify your backend is getting real-time updates. ### refund_billing_payment Processes a full or partial refund for a specific captured payment. This lets you handle customer issues instantly without leaving your chat. ## Prompt Examples **Prompt:** ``` Did the customer who just signed up actually pay? ``` **Response:** ``` Checking payment status... I've verified the transaction for user 'j_doe_99'. The payment of $49.00 was successfully captured. You can see the full details below: **Status:** Captured **Amount:** $49.00 **ID:** pay_88231 ``` **Prompt:** ``` I need to send a link for a $150 custom service. ``` **Response:** ``` I've created that checkout session for you. You can send this secure link to your client: [Link] **Session ID:** chk_5521 **Amount:** $150.00 USD ``` **Prompt:** ``` Show me all the active subscriptions we have right now. ``` **Response:** ``` Here are your current recurring plans: | Plan Name | Status | Monthly Price | | :--- | :--- | :--- | | Pro Plan | Active | $29.00 | | Enterprise | Active | $199.00 | | Basic | Inactive | $9.00 | ``` ## Capabilities ### Create new checkout sessions Generate secure payment links for products or services instantly. ### Process payment refunds Handle full or partial refunds for captured payments through your chat. ### Fetch customer profiles Get detailed metadata and billing info for any customer in your database. ### Monitor revenue streams List all processed payments and check their status in one go. ### Track recurring plans Pull a list of active and inactive subscriptions to see your long-term health. ### Review invoice history Access and list all generated invoices for your billing records. ### Verify webhook status Check your configured webhooks to ensure your systems are getting real-time updates. ## Use Cases ### Verifying a disputed payment A customer claims they paid but the order hasn't shipped. A support agent uses get_payment_details to verify the status in seconds. ### Quick revenue snapshots A founder needs a quick snapshot of today's revenue. They ask the agent to list_billing_payments for today to see the total. ### Instant checkout links A salesperson closes a deal in a chat. They use create_checkout_session to send a payment link immediately to the new lead. ### Rapid refund processing A user wants a refund for a double charge. The manager uses refund_billing_payment to fix it for the customer without logging in. ## Benefits - Cut out the dashboard fatigue by using list_billing_payments to see your revenue history without opening a new tab. - Speed up customer support by using get_customer_details to pull billing info instantly during a live chat. - Automate your sales flow by using create_checkout_session to generate payment links the moment a deal is closed. - Handle disputes faster by using refund_billing_payment to issue credits directly from your primary workspace. - Keep your data synced by using list_payment_webhooks to verify that your internal systems are receiving updates. - Monitor your churn and growth by using list_billing_subscriptions to see your recurring revenue health at a glance. ## How It Works The bottom line is you get a direct, conversational interface for your entire Getpaid billing operation. 1. Subscribe to the Getpaid MCP on the Vinkius Marketplace. 2. Plug in your Client ID and Client Secret from your Getpaid Integration Settings. 3. Ask your AI client to check a payment status or create a checkout link. ## Frequently Asked Questions **Can I use Getpaid MCP to handle my entire business's accounting?** No, this Connector is specifically for managing payments, checkouts, and subscriptions through Getpaid. It doesn't replace your full accounting software like Quickbooks, but it does let your AI handle the day-to-day billing tasks. **How do I use Getpaid MCP to send payment links to customers?** You can simply ask your AI agent to create a checkout session for a specific amount. It will generate a secure link that you can then copy and share with your customer immediately. **Can Getpaid MCP process refunds for my customers?** Yes, you can use the agent to process full or partial refunds for any captured payments. This saves you from having to log into the Getpaid dashboard to find the specific transaction and trigger the refund manually. **Does Getpaid MCP work with Claude or Cursor?** Yes, this Connector is designed to work with any MCP-compatible client, including Claude, Cursor, and Windsurf. Once connected via Vinkius, your agent can access all your billing data. **Is my financial data secure with the Getpaid MCP?** Yes, the Connector uses your existing Getpaid Client ID and Secret to authenticate. Your data remains within the Getpaid ecosystem, and the AI only accesses the specific information you request through the tools. **How do I see if my webhooks are working correctly?** You can ask your agent to list your payment webhooks. It will show you all your configured configurations so you can verify that your internal systems are receiving real-time notifications. **How do I get a Client ID and Secret for Getpaid?** Log in to your Getpaid dashboard, navigate to Settings > Integrations, and you can create a new API integration to retrieve your Client ID and Client Secret. **In what units should I provide the payment amount?** The API uses minor units for currency. For example, to charge $1.00 USD, you must provide the value 100 (cents). **Can I process refunds through the agent?** Yes! Use the 'refund_billing_payment' tool and provide the specific Payment ID. You can also specify a custom amount for a partial refund. **How do I check if a checkout session was completed?** Use the 'get_checkout_status' tool with the Checkout ID. The agent will return the current state, such as 'completed', 'pending', or 'expired'.