# Fusebill Billing MCP

> Fusebill (Enterprise Subscription Billing API) automates complex billing operations directly through your AI agent. Manage customer records, track subscriptions, and control the full billing lifecycle—from creation to cancellation—without leaving your chat window. Use this MCP to handle all enterprise subscription management tasks.

## Overview
- **Category:** finance-accounting
- **Price:** Free
- **Tags:** subscription-management, enterprise-billing, recurring-revenue, customer-billing, saas-billing

## Description

This connector lets you manage an entire company's subscriber base using natural conversation. Instead of logging into the Fusebill dashboard or running multiple reports, your AI agent interacts directly with your billing data. You can use it to list and retrieve customer profiles, checking things like email addresses and currency settings on demand. Need to change a subscription? Your agent handles that too, allowing you to activate new customers or cancel old ones instantly. It also lets you query both active and historical subscriptions, giving immediate visibility into your recurring revenue stream. Because this MCP is hosted on Vinkius, all your billing data becomes one accessible point for any compatible AI client, keeping your workflow tight and focused.

## Tools

### activate_customer
Changes a customer's status to active within Fusebill.

### cancel_customer
Deactivates and cancels an entire customer record in the system.

### create_customer
Adds a brand new customer account to Fusebill.

### get_customer
Fetches all specific details for one identified customer by ID or criteria.

### get_subscription
Retrieves the complete profile and status of a single subscription plan.

### list_customers
Searches, filters, and returns paginated lists of multiple customer records.

### list_subscriptions
Generates a filtered list of multiple subscriptions based on criteria like date or plan type.

## Prompt Examples

**Prompt:** 
```
List all Fusebill customers with the first name 'Jessica'.
```

**Response:** 
```
I've searched your records. I found 2 customers matching 'Jessica': Jessica Jones (ID: 44556) and Jessica Smith (ID: 77889). Would you like to see the full details for either of them?
```

**Prompt:** 
```
Get the details for subscription ID 987654.
```

**Response:** 
```
Retrieving subscription 987654... This is an 'Active' subscription for 'Global Enterprise' plan, billing in USD. It is currently assigned to customer 'Tech Solutions Inc'.
```

**Prompt:** 
```
Create a new customer: Michael Scott, email michael@dundermifflin.com, currency USD.
```

**Response:** 
```
Processing... Customer 'Michael Scott' has been successfully created with ID 102938. The primary email is set to michael@dundermifflin.com and currency is USD. Would you like to activate this customer now?
```

## Capabilities

### Manage Customer Records
Create, retrieve details for, list, or modify the status of entire customer accounts.

### Track Subscription Statuses
Get current and historical information about any subscription plan, including billing cycle details.

## Use Cases

### Onboarding a New Client
A Customer Success Manager needs to set up a brand new enterprise client. Instead of logging into Fusebill, they ask their agent to 'create a customer' with the required details. The agent processes the data and confirms the ID immediately, allowing the CSM to move straight to contract signing.

### Auditing Account Status
The billing ops team needs to verify if a specific client was correctly moved from 'Trial' to 'Paid'. They simply ask their agent to `get_subscription` for the ID, and the agent returns the current status ('Active') and plan details instantly.

### Pre-Cancellation Review
A client is questioning their bill. The team asks the agent to 'list all subscriptions' associated with that account's domain. This action pulls up historical data, showing when the service was active and what plans were used.

## Benefits

- Stop switching dashboards. You can now use your AI agent to handle account setup, like using `create_customer`, without you lifting a finger on external portals.
- Get instant answers about revenue. Instead of manually running reports, ask your agent to `list_subscriptions` and see current recurring revenue figures immediately.
- Manage accounts at scale. Use `list_customers` to pull batches of customer records for bulk review or data export in minutes.
- Handle status changes easily. Need to close an old account? You can use `cancel_customer` directly through conversation, keeping the record clean.
- Deep dive on any account. If you only have a partial ID, your agent can run `get_customer` and pull all required metadata for that user.

## How It Works

The bottom line is, your AI agent treats your entire Fusebill account like a conversational database.

1. Subscribe to this MCP on Vinkius and provide your Fusebill API key.
2. Your AI client connects using the credentials to access all customer and subscription data.
3. You tell your agent what you need—like 'list all customers in USD' or 'check my billing for X ID'—and it executes the action.

## Frequently Asked Questions

**Can I create a new customer directly through the AI?**
Yes! Use the `create_customer` tool by providing the first name, last name, and optional details like email and currency. The agent will confirm the creation and return the new Customer ID.

**How do I check the status of a specific subscription?**
Simply provide the Subscription ID to the `get_subscription` tool. The agent will retrieve the full metadata, including its current status, plan details, and associated customer information.

**Is it possible to cancel a customer's account using this integration?**
Yes, the `cancel_customer` tool allows you to change a customer's status to 'Cancelled' using their unique Customer ID. This action is performed securely through the Fusebill API.