# Getpaid MCP

> Getpaid is an MCP that lets you automate billing, process payments, and handle checkouts directly through your AI agent. Connect it to manage customer records, track invoices, and initiate refunds for SaaS or marketplace operations.

## Overview
- **Category:** finance-accounting
- **Price:** Free
- **Tags:** saas-billing, payment-gateway, checkout-automation, transaction-tracking, invoicing

## Description

Running a subscription service means constantly juggling payment statuses, tracking recurring revenue, and verifying transactions—all things that used to require clicking through multiple dashboards. This MCP connects Getpaid's full capabilities to your AI agent, letting you handle these financial tasks using natural conversation instead of manual clicks. You can ask it to list all recent payments or pull up a customer’s complete billing history instantly. It handles everything from creating secure checkout sessions to processing partial refunds with just a simple prompt. By connecting this MCP through Vinkius, your agent gets real-time access to payment data without you ever having to leave your primary workspace. You manage complex financial flows—like listing active subscriptions or checking webhook configurations—all while chatting.

## Tools

### verify_api_connection
Checks if your AI agent has successfully connected to your Getpaid account.

### create_checkout_session
Starts a new payment session for a specific amount, generating a unique checkout link.

### get_account_details
Retrieves general information about your Getpaid account identity.

### get_checkout_status
Checks the current status of a payment session using its unique ID.

### get_customer_details
Fetches detailed metadata for any customer associated with your billing account.

### get_payment_details
Retrieves full payment metadata, including status and timestamps, for a specific transaction.

### list_billing_customers
Lists all customers who have paid through your platform.

### list_billing_invoices
Retrieves a list of all generated invoices and their corresponding details.

### list_billing_payments
Lists every processed payment record, allowing you to monitor your overall revenue flow.

### list_billing_subscriptions
Shows all active and inactive recurring billing plans for subscription management.

### list_payment_webhooks
Displays the configurations of webhooks to confirm real-time notification setup.

### refund_billing_payment
Processes a full or partial refund for any captured payment directly through the agent conversation.

## Prompt Examples

**Prompt:** 
```
List all payments processed today.
```

**Response:** 
```
Retrieving payments... I found 5 payments processed today, including a $50.00 charge (Status: Captured) and a $15.00 charge. Would you like the full details for any of them?
```

**Prompt:** 
```
Create a checkout session for $25.00 USD.
```

**Response:** 
```
Checkout initiated! I've successfully created a session for 2500 cents ($25.00 USD). The Checkout ID is 'chk_abc123'. You can share this link with the customer: [Payment Link].
```

**Prompt:** 
```
Refund payment 'pay_98765' for the full amount.
```

**Response:** 
```
Refund processed! I have successfully initiated a full refund for payment pay_98765. The status is now 'refunded' and the customer will see the credit shortly.
```

## Capabilities

### Handle payments and refunds
Process full or partial refunds against existing charges, or monitor the status of recent transactions.

### Manage customer billing data
Retrieve detailed information on specific customers, list all associated invoices, and review their payment history.

### Automate revenue collection
Initiate new checkout sessions for products or services and check the status of those payments.

### Audit billing activity
List all processed transactions, review recurring subscription plans, and monitor webhook setups.

## Use Cases

### A customer claims they were double-billed for a service renewal.
Instead of pulling up the dashboard, the agent uses get_payment_details to find two recent charges. You confirm the mistake and use refund_billing_payment to issue the credit immediately, providing proof straight from chat.

### You need to onboard a new client and process their first payment.
The agent uses create_checkout_session for the initial amount. Once complete, it checks get_checkout_status to confirm success before sending the welcome materials. This entire flow takes minutes.

### An internal audit requires a list of all payment methods used this quarter.
The agent uses list_billing_payments and then filters by date range, compiling a comprehensive report on transaction volume and types without needing access to the raw database UI.

### Your team needs to check if webhooks are correctly firing for payment updates.
The agent runs list_payment_webhooks. This quickly confirms that your internal system is configured to receive real-time data notifications, saving manual debugging time.

## Benefits

- Process refunds without leaving your chat. You can use the refund_billing_payment tool to immediately issue credits for failed or disputed transactions.
- Stop manually checking statuses. Your agent pulls up payment details using get_payment_details so you know exactly where a customer's money is at any time.
- Automate setup and testing by running create_checkout_session, which instantly generates secure links for your team to use with clients.
- Get a complete financial picture. You can list billing invoices or check out list_billing_payments to audit revenue flow across different months.
- Manage recurring revenue easily. The list_billing_subscriptions tool lets you see if your core subscription plans are active and generating expected income.

## How It Works

The bottom line is getting complex financial data and actions done through simple conversation rather than navigating a dashboard.

1. Subscribe to this MCP on the Vinkius Marketplace using your Getpaid Client ID and Secret.
2. Connect it within any compatible AI client (Claude, Cursor, Windsurf, etc.) so your agent can access payment data.
3. Tell your agent what you need—for example, 'List all payments processed last week'—and the system executes the necessary function.

## Frequently Asked Questions

**How do I list all payments using Getpaid MCP?**
You use the list_billing_payments tool. This function gathers every payment record, giving you a clear overview of your recent revenue flow directly within the chat.

**Can I process refunds with Getpaid MCP?**
Yes. You call refund_billing_payment and provide the specific payment ID to initiate the full or partial credit immediately through your agent.

**What is the difference between list_billing_payments and list_billing_invoices?**
list_billing_payments shows every transaction (the actual money movement). list_billing_invoices provides the structured records of what was billed to the customer.

**Does Getpaid MCP help with new checkouts?**
Absolutely. You use create_checkout_session to initiate a secure payment flow, which gives you a unique link and status that your agent can track for you.

**Is get_customer_details enough for billing needs?**
No. While it gets basic customer metadata, use list_billing_customers or get_payment_details to get the actual financial records needed for reporting.