# Billsby MCP for AI Agents AI Agent Connect > Billsby MCP lets you manage your subscription billing through your AI agent. You can pull customer lists, check subscription statuses, audit invoices, and view your product catalog directly from your chat interface. It connects your billing data to your workspace so you can handle tasks without leaving your current app. ## Overview - **Category:** ecommerce - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_UptISq5oMmxDwDx9d6aq6UCbdfptKEVxv7fDxwUr/ai-agent-connect - **Tags:** recurring-billing, saas-billing, subscription-management, customer-retention, invoicing, revenue-management ## Description Managing a subscription business usually means jumping between tabs to see who's paid, who's on which plan, and what's actually coming in this month. It's a lot of context switching. This Connector changes that by bringing your billing data straight into your AI client. Instead of hunting for a specific customer ID or digging through a dashboard to see if a plan has active add-ons, you just ask. You can pull up a list of everyone on your platform, check the status of a specific recurring payment, or see what products you're currently offering. It makes it way easier to handle support tickets or do a quick revenue check on the fly. When a user asks about a charge, you don't have to go hunting for their history. You can just ask your agent to pull it up. This saves time on every single interaction. Since Vinkius handles the connection for you, you just plug in your API key and start talking to your data. It turns your agent into a billing specialist that knows your customers and your pricing as well as you do. You can check your current product catalog to see what's live, or get a full list of your customers to see how many people are signed up. It puts all your billing data in one place where you can actually use it. ## Tools ### list_products See every product you have listed. This is your go-to for checking your full catalog of offerings. ### create_customer Add a new customer to your billing system. This lets you onboard new users without leaving your chat app. ### get_customer_subscriptions Find the specific plans a customer is signed up for. This is perfect for troubleshooting user access issues. ### get_customer Pull up the full profile for a specific user. Use this to see the exact details of any customer in your system. ### get_subscription See the specific details of a single subscription. It's the fastest way to check a user's current plan status. ### list_addons See all the extra features you offer as add-ons. This helps you understand what extra revenue streams are available. ### list_customers Get a list of every customer in your account. Use this to see your total reach or find a specific account. ### list_invoices See your most recent invoices. This helps you keep a close eye on your cash flow and payment history. ### list_plans See every subscription plan you offer. This helps you stay clear on your current pricing tiers. ### list_subscriptions Get a full list of all active subscriptions. Use this to see the scale of your current recurring revenue. ## Prompt Examples **Prompt:** ``` Show me the last 5 invoices we received. ``` **Response:** ``` I've pulled the most recent invoices for you: | Invoice ID | Date | Amount | Status | | :--- | :--- | :--- | :--- | | #INV-8821 | Oct 01 | $49.00 | Paid | | #INV-8819 | Sep 28 | $49.00 | Paid | | #INV-8815 | Sep 25 | $120.00 | Paid | | #INV-8812 | Sep 20 | $49.00 | Paid | | #INV-8809 | Sep 15 | $49.00 | Paid | ``` **Prompt:** ``` What plans do we currently offer? ``` **Response:** ``` You currently have 3 active plans: * **Basic**: $10/mo * **Pro**: $25/mo * **Enterprise**: Custom Pricing You also have several add-ons available for users to upgrade their experience. ``` **Prompt:** ``` Does customer c_482 have any active add-ons? ``` **Response:** ``` I've checked the subscription for customer **c_482**. They are currently on the **Pro** plan and have the following active add-ons: * Premium Analytics * Priority Support * Extra Storage (50GB) ``` ## Capabilities ### Pull customer lists Get a full view of your user base instantly. ### Check plan details See what's included in your different subscription tiers. ### Create new profiles Add new customers to your billing system via chat. ### Audit recent invoices See payment statuses and history for your latest bills. ### View product catalogs See your full list of products and pricing structures. ### Look up add-ons Check what extra features are available for your users. ## Use Cases ### Support Ticket Triage A support agent gets a message about a billing error. They ask the agent to use `get_customer_subscriptions` to see what the user is actually paying for. ### Monthly Revenue Audit A founder wants to see the latest numbers. They ask the agent to use `list_invoices` to summarize the last 30 days of billing. ### Onboarding a New Client A salesperson finishes a deal. They ask the agent to use `create_customer` to get the new user into the system immediately. ### Plan Comparison A product manager wants to see what's in the "Pro" vs "Enterprise" tiers. They ask the agent to use `list_plans` and `list_addons`. ## Benefits - Faster support responses: Use `get_customer_subscriptions` to tell users exactly what they're paying for in seconds. - Instant revenue checks: Use `list_invoices` to see your latest cash flow without opening another browser tab. - Easier onboarding: Use `create_customer` to add new users to your billing system while you're still in your chat window. - Clearer product oversight: Use `list_products` and `list_plans` to keep your pricing and offerings organized. - Better customer visibility: Use `list_customers` to get a high-level view of your entire user base on demand. ## How It Works The bottom line is you get a direct line to your billing data without the dashboard fatigue. 1. Subscribe to the Billsby MCP on Vinkius. 2. Add your Billsby API Key and Company Domain to your client settings. 3. Ask your agent to list customers, check invoices, or manage plans. ## Frequently Asked Questions **What can the Billsby MCP do for my SaaS?** It gives your AI agent direct access to your billing data. You can query customer lists, check subscription statuses, and audit invoices without leaving your chat window. **How do I use Billsby MCP to check customer plans?** You can simply ask your agent to show you the plans for a specific customer. It will pull the details instantly so you can answer support questions faster. **Can I use Billsby MCP to see my monthly revenue?** Yes, you can ask your agent to list recent invoices. It will pull the latest billing records so you can get a quick sense of your current cash flow. **How do I connect Billsby MCP to my AI agent?** Just subscribe to the Connector via Vinkius and add your Billsby API Key and Company Domain to your client settings. Your agent will then have the permissions it needs. **Does Billsby MCP help with support tickets?** It's a huge help for support. Instead of digging through a dashboard, your agent can pull up a user's payment history and active plan details while you're talking to them. **Can I add new customers using Billsby MCP?** Yes, you can ask your agent to create a new customer profile. It will handle the data entry into your billing system for you. **Can I check which subscription plan a customer is currently on?** Yes! Use the `get_customer_subscriptions` tool with the Customer Unique ID. It will fetch all active and inactive plans for that user. **Does the integration allow me to cancel a subscription?** Currently, the toolset focuses on querying and management functions (listing customers, checking invoices). Canceling or modifying subscription billing dates must be done on the Billsby platform. **Can I list all available subscription plans?** Yes. Use the `list_plans` tool to retrieve all subscription plans configured in your Billsby account, including their pricing and cycles.