# ChargeDesk MCP for AI Agents MCP

> ChargeDesk provides AI agents full control over billing and payments, letting you manage accounts across multiple gateways—Stripe, PayPal, Braintree, and more—from a single chat interface. You can track charges, process refunds, monitor customer subscriptions, and audit connected payment systems without logging into separate dashboards.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** payment-gateway-integration, refund-management, billing-support, unified-dashboard, customer-billing, transaction-tracking

## Description

Connect your ChargeDesk account to any AI agent and handle all billing operations through natural conversation. Instead of opening Stripe, then PayPal, then Braintree in different tabs, your agent pulls all this data together. Need to know why a customer was charged $50 last month? Your agent pulls the charge details immediately. Want to fix an overcharge? You tell it to process a partial refund, and it does it. It also lets you list out every connected payment gateway so you can confirm everything is working right. This centralized view means your support team spends less time hunting down transaction IDs and more time actually helping customers. Because Vinkius hosts this MCP, your agent has access to all these financial tools in one place.

## Tools

### get_charge_details
Pulls detailed information for a single, specific charge ID.

### get_customer_details
Retrieves the complete profile and billing history for a specified customer.

### list_chargedesk_charges
Generates a list of recent charges from every connected payment gateway.

### list_chargedesk_customers
Lists all existing customers in your ChargeDesk account.

### list_connected_gateways
Shows a list of every payment gateway currently linked to the account.

### list_chargedesk_subscriptions
Retrieves details for both active and inactive customer subscriptions.

### list_chargedesk_webhooks
Shows a list of all configured webhooks and account alerts.

### refund_chargedesk_payment
Initiates a full or partial refund for a specific charge ID.

## Prompt Examples

**Prompt:** 
```
What were all my total charges last month across Stripe and PayPal?
```

**Response:** 
```
**Monthly Charge Summary**

*   **Total Period:** May 1 - May 31
*   **Overall Spend:** $12,850.00
*   **Gateway Breakdown:**
    *   Stripe: $9,100.00 (45 charges)
    *   PayPal: $3,750.00 (22 charges)
    *   Braintree: $0.00

Do you need details on any specific transaction ID?
```

**Prompt:** 
```
I need to refund the charge for Customer X because they cancelled.
```

**Response:** 
```
**Refund Action Taken**

✅ **Success:** Partial refund of $25.00 initiated for Charge ID `ch_987xyz`. 
*   **Original Gateway:** Stripe (Live)
*   **New Status in System:** Partially Refunded.
*   **Confirmation:** The original payment processor has been notified, and the status will update shortly.
```

**Prompt:** 
```
Show me all my active subscriptions and if they are paid up.
```

**Response:** 
```
**Subscription Overview (Current)**

The following 5 customers have active billing cycles:

| Customer ID | Plan Level | Next Billing Date | Status |
| :---: | :---: | :---: | :---: |
| cust_101 | Premium | 2026-07-15 | Active |
| cust_109 | Basic | 2026-08-01 | Active |
| cust_344 | Trial | N/A | Inactive |

All active accounts are reporting payment health.
```

## Capabilities

### View Payment History
List recent charges across all connected payment gateways so you can review spending patterns.

### Refund Payments
Process full or partial refunds for specific transactions using a simple command.

### Get Customer Records
Access and monitor detailed customer profiles, including their complete billing history.

### Manage Subscriptions
List details for both active and inactive customer subscriptions to verify account status.

### Audit Connections
Get a list of all connected payment gateways and confirm their operational status.

## Use Cases

### A customer disputes a charge they didn't recognize.
The support agent uses the MCP to run `get_customer_details` and cross-references the disputed date against recent charges. This quickly reveals if the charge came from an unexpected source, leading to a swift resolution.

### A monthly billing cycle needs adjustments.
The finance manager runs `list_chargedesk_subscriptions` to check all renewal dates and then uses the MCP to process necessary refunds or credits directly through the agent's interface, documenting everything automatically.

### System maintenance requires checking payment processors.
The ops engineer runs `list_connected_gateways` before a major deployment. This confirms all expected gateways—Stripe, PayPal, etc.—are online and reporting healthy status, preventing site outages.

### A bulk refund is needed after a service outage.
The business owner uses the agent to first `list_chargedesk_charges` for the affected period, then iterates through the list, using `refund_chargedesk_payment` for every relevant transaction.

## Benefits

- Process refunds instantly. Instead of navigating to a gateway's dashboard, you simply tell your agent which charge needs a partial refund using the `refund_chargedesk_payment` tool.
- Stop context switching. You get unified oversight by listing charges across all gateways with one command, giving you total financial visibility immediately.
- Better customer support means faster resolutions. Use `get_customer_details` to pull up a full billing history for any user in seconds, without asking them to email receipts.
- Stay audit-proof. Quickly verify your entire system health by running `list_connected_gateways`, ensuring every payment processor is active and ready.
- Keep subscriptions straight. The `list_chargedesk_subscriptions` tool lets you check if an account is active or lapsed, preventing revenue loss from confusion.

## How It Works

The bottom line is that instead of managing billing through separate websites, you talk to your agent and it handles the complexity across every connected gateway.

1. First, subscribe to this MCP and input your ChargeDesk Secret Key into Vinkius.
2. Next, connect your preferred AI client (like Claude or Cursor) to the Vinkius catalog.
3. Finally, tell your agent what you need—for example, 'Find all charges over $100 last month'—and it runs the reports for you.

## Frequently Asked Questions

**How does ChargeDesk MCP help me view payments from multiple gateways?**
It gives you a single, unified dashboard for all your transactions. You don't need to log into Stripe or PayPal separately; the agent pulls the details from every linked gateway in one place.

**Can I use ChargeDesk MCP to process refunds?**
Yes. It lets you initiate full or partial refunds for any charge ID right through your chat interface, saving you the step of logging into each payment processor's portal.

**What information can I get about a specific customer using this MCP?**
You get much more than just their name. The system pulls up their complete billing history, current subscription status, and all associated charges from every gateway you use.

**Is ChargeDesk MCP only for checking transactions?**
No, it's fully operational. You can check records, but you also have the ability to take action, like listing gateways or initiating refunds.

**Do I need technical knowledge to use ChargeDesk MCP?**
Absolutely not. This is designed for natural conversation. You just tell your agent what you want—like 'Show me all failed payments'—and it handles the complex API calls.

**Can I audit my payment connections with ChargeDesk MCP?**
Yes, you can list every gateway connected to your account. This is great for verifying that all processors are still active and reporting correctly.