# Younium MCP MCP > Younium manages B2B subscription infrastructure directly through conversation. This MCP lets you list all active subscriptions, check revenue metrics (MRR, ARR), create new customer accounts, and audit billing history for any SaaS business. Use it when you need to manage the full lifecycle of recurring service contracts. ## Overview - **Category:** money-moves - **Price:** Free - **Tags:** saas-billing, recurring-revenue, subscription-management, b2b-finance, contract-management, financial-metrics ## Description Need to track down a customer's contract details or run a quick financial report without logging into three different dashboards? This MCP connects your AI agent directly to Younium, letting you handle complex billing operations using plain chat. You can list every active subscription version, check the total recurring revenue (MRR/ARR), and even provision brand new accounts for customers. The system handles everything from listing all products available in the catalog to terminating an unwanted service immediately. When dealing with financial records this detailed, auditability is key. That’s why Vinkius's platform ensures every tool call generates a cryptographically signed, tamper-proof audit trail; you always know exactly when and how data moved through the system. This lets finance teams reconcile complex billing cycles instantly. ## Tools ### cancel_subscription Immediately terminates a specific recurring billing service version when given the necessary IDs and an effective date. ### create_account Creates a new customer billing account record by providing required configuration details in JSON format. ### create_subscription Generates a brand-new subscription contract for an existing customer account using specific JSON parameters. ### get_account Retrieves deep details, including tax IDs and full records, for any specified Younium customer account. ### get_metrics Calculates and returns real-time financial figures like MRR, ARR, and TCV based on a given subscription ID. ### get_subscription Retrieves all details about a single contract, including its historical version changes over time. ### list_accounts Provides an exhaustive list of every customer account registered within the Younium ERP system. ### list_invoices Lists all generated invoices from the platform and shows their current payment status (e.g., PAID, POSTED). ### list_products Returns a list of every billable product available in the Younium catalog, detailing associated charge plans. ### list_subscriptions Lists all current recurring billing subscriptions tied to an account within the system. ## Prompt Examples **Prompt:** ``` List the last 5 subscriptions in my Younium account. ``` **Response:** ``` I found 5 active subscriptions: 1. 'Enterprise License' for Acme Corp (ID: sub-101), 2. 'SaaS Pro' for Global Tech (ID: sub-102), 3. 'API Add-on' for Stark Industries (ID: sub-103), and 2 others. Which one would you like to see metrics for? ``` **Prompt:** ``` What is the MRR and ARR for the subscription with ID 'sub-101'? ``` **Response:** ``` Subscription sub-101 (Acme Corp): Current MRR is $1,250.00 and ARR is $15,000.00. The Total Contract Value (TCV) is $45,000.00 over a 3-year term. Would you like me to pull the invoice history for this contract? ``` **Prompt:** ``` List the last 3 invoices for Acme Corp (Account: acc-123). ``` **Response:** ``` I found 3 invoices for Acme Corp: 1. INV-2026-001 ($1,250.00, Status: PAID), 2. INV-2026-002 ($1,250.00, Status: POSTED), and 3. INV-2026-003 ($1,250.00, Status: DRAFT). Would you like to see the breakdown for the unpaid one? ``` ## Capabilities ### Audit Account Status Retrieve detailed information for any specific customer account in the Younium ERP. ### Manage Subscriptions Create new contracts or immediately terminate existing subscriptions by providing the necessary IDs and effective dates. ### Analyze Financial Health Get real-time financial metrics like Monthly Recurring Revenue (MRR) and Total Contract Value (TCV) for specific services. ### Process Billing Records List all generated invoices, checking their payment status—Draft, Posted, or Paid—across the customer base. ### Discover Products and Plans Browse the entire catalog of billable products and associated charge plans to verify pricing structures. ## Use Cases ### The Renewal Check A Sales Success Manager needs to know if an account's service is up-to-date before a renewal call. They ask the agent, and it uses `get_subscription` to pull the contract details, showing exactly when the last payment was made and what version of the service they are on. ### Monthly Reconciliation The Finance Analyst needs to reconcile Q3 revenue. They ask for all invoices using `list_invoices`, and the agent immediately provides a count grouped by status (PAID vs. DRAFT), allowing them to flag missing payments instantly. ### Quick Termination A Support Engineer must shut down services flagged for non-payment. They tell the agent, which then executes `cancel_subscription` using the provided service ID and effective date, ensuring immediate system action. ### New Client Onboarding The Ops team needs to onboard a new large client quickly. The agent first uses `create_account` to set up the record, then follows up by using `list_products` to confirm which service plans they should start with before running `create_subscription`. ## Benefits - Instead of manually querying multiple billing screens, you can list all recurring subscriptions using `list_subscriptions` to get an immediate overview of the entire customer base's contracts. - Verify financial health instantly. By calling `get_metrics`, your agent delivers the MRR, ARR, and TCV figures in a single response, eliminating spreadsheet lookups. - You can manage account growth by creating new records using `create_account` or spinning up services with `create_subscription`—all through simple chat commands. - Need to check if a client paid? Running `list_invoices` gives you the payment status (PAID, DRAFT, etc.) for every invoice without clicking into dozens of PDF attachments. - The MCP lets you handle complex service changes. Use `cancel_subscription` with just IDs and dates to terminate services immediately, which is critical for churn control. - Getting account details used to require navigating deep menus. Now, a single call to `get_account` brings the full customer record—including tax IDs—straight to your agent. ## How It Works The bottom line is, you treat your entire subscription management system like a single conversation thread with your AI agent. 1. First, subscribe your agent to this MCP and provide a valid Younium JWT Token. 2. Next, prompt your AI client with the specific task: 'What is the MRR for account X?' or 'List all invoices for Q3.' 3. The agent executes the necessary billing tool call and returns the structured data directly in the chat response. ## Frequently Asked Questions **How do I find out what services an account has?** Run `list_subscriptions` to get a full list of all active contracts associated with the customer. This shows you exactly what they are currently paying for. **What is MRR and ARR using `get_metrics`?** MRR (Monthly Recurring Revenue) is the predictable revenue stream each month. ARR calculates that over a full year. You must provide a specific subscription ID to get accurate figures. **Can I add new accounts using `create_account`?** Yes, you can create a brand-new customer billing account record by providing all the necessary configuration details in JSON format. This starts the entire client relationship within Younium. **How do I check if an invoice was paid?** Use `list_invoices`. The tool will return a list of invoices and their status, clearly marking whether they are DRAFT, POSTED, or PAID. **When I use the MCP, what security precautions are in place when running a tool like `get_account`?** The platform uses zero-trust proxies for all credentials. Your keys pass through these proxies but never get stored on disk. This means your sensitive data is secured during transit and remains isolated from the underlying system. **What happens if I try to terminate a subscription using `cancel_subscription` with an ID that doesn't exist?** The MCP will return a specific error code indicating the missing resource. Your agent can then catch this error and prompt you for the correct subscription or version ID, preventing failed operations. **Before I call `create_subscription`, how do I check all available pricing plans using `list_products`?** Running `list_products` provides a full catalog of every billable product and its associated charge plan. You can use this output to select the precise details needed before creating a new subscription record. **Does running `get_account` provide deep customer data like tax IDs, or just basic account names?** The tool retrieves comprehensive records that include deep details for your enterprise SaaS customers. You'll get access to critical information such as full tax IDs and detailed billing configuration right through the agent. **Can I check the MRR and ARR metrics for a specific customer contract?** Yes. The `get_contract_metrics` tool allows your AI agent to retrieve real-time Monthly Recurring Revenue (MRR), Annual Recurring Revenue (ARR), and Total Contract Value (TCV) for any specific subscription ID. **How do I see if a customer's latest invoice has been paid?** You can use the `list_invoices` tool. Your AI agent will return a list of recent invoices along with their current status, such as 'DRAFT', 'POSTED', or 'PAID', helping you audit financial activity through chat. **Is it possible to terminate a subscription via conversation?** Absolutely. Using the `cancel_subscription_version` tool, you can instruct your agent to terminate a specific subscription. You'll need to provide the subscription and version IDs plus the effective cancellation date.