# Polar MCP > Polar MCP connects your AI client to digital commerce operations. Manage everything—from listing products and tracking subscriptions to creating checkouts and auditing revenue—all through natural conversation. You control your entire storefront, discounts, customer data, and order history without opening the web dashboard. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** creator-economy, digital-products, subscription-billing, checkout-flow, revenue-tracking, monetization ## Description Your agent gains full access to your digital commerce backend via this MCP. Instead of logging into the Polar dashboard to answer questions about sales or inventory, you just ask. Need to know if a specific customer has an active subscription? Your agent checks that instantly. Want to see all products and check their current pricing structure? It pulls the catalog for you. You can create new discount codes on the fly or audit previous checkout sessions to track abandoned carts. This gives your AI client the power of a dedicated commerce engineer, allowing it to run complex reports and execute operations right where you work. Connecting this MCP through Vinkius means you keep all your core business tools visible in one place, making your digital product management instantaneous. ## Tools ### create_checkout Generates a new payment link for specific products, allowing you to optionally apply a discount code first. ### create_discount Creates an entirely new promotional coupon code in Polar with defined amounts and durations. ### get_product Retrieves all details for a single product using its unique ID. ### list_checkouts Shows the status, associated products, and customer data for abandoned or completed checkout sessions. ### list_customers Retrieves a list of customers, letting you filter by email or name to find specific accounts. ### list_discounts Provides an audit list of all current discount codes, including their type and active status. ### list_orders Lists every order placed, detailing the customer, product, amount, and payment confirmation status for revenue tracking. ### list_products Retrieves a full list of all available products, showing if they are one-time purchases or subscriptions. ### list_subscriptions Shows the status and billing details for every customer subscription, including start/end dates. ### list_webhooks Lists all configured event endpoints to audit which services are connected to Polar. ## Prompt Examples **Prompt:** ``` Show me all active subscriptions and their total monthly revenue. ``` **Response:** ``` I found 23 active subscriptions. Monthly recurring revenue is $1,847 across 12 products. The top product is 'Pro Plan' at $29/mo (18 subscribers). Would you like a breakdown by product? ``` **Prompt:** ``` Create a 20% discount code called 'LAUNCH20' for the summer sale. ``` **Response:** ``` Done! I've created the discount code 'LAUNCH20' with 20% off, duration set to 'once'. Customers can now apply this code during checkout. The discount is active immediately. ``` **Prompt:** ``` Show me all orders from the last 30 days. ``` **Response:** ``` I found 47 orders totaling $3,219.50. The highest-value order was $199.00 for 'Enterprise Plan'. Average order value is $68.50. Would you like details on any specific order? ``` ## Capabilities ### Audit the entire product catalog List every product, whether it's a single purchase item or an ongoing subscription, along with its pricing details. ### Track customer billing status Retrieve detailed information on customers and monitor their active, canceled, or past-due subscriptions. ### Review order history and revenue List completed transactions showing the customer, product purchased, final amount, and payment status for revenue tracking. ### Generate checkout sessions Create a new billing session for specified products, optionally applying a discount code to generate a unique payment link. ### Manage promotional codes List existing discount codes or create entirely new ones with fixed amounts or percentage reductions. ## Use Cases ### Investigating an unusual payment failure A client reports they were charged twice. Instead of manually searching the dashboard, they ask their agent to list all orders for that customer in the last week using `list_orders`. The agent filters and pinpoints both transactions, allowing immediate resolution. ### Preparing a seasonal promotion The marketing team needs a limited-time discount. They ask their agent to create a new promotional code via `create_discount`, set it for a fixed 30% off, and confirm its immediate availability before the launch. ### Onboarding a new developer A dev needs product details for an upcoming feature. They prompt their agent to use `list_products` first to see available categories, then use `get_product` on a specific UUID to pull all metadata. ### Handling customer service inquiries A user calls about renewal status. The support tech asks their agent to check the account using `list_subscriptions`. The agent immediately reports if the subscription is active, past due, or canceled, letting the tech resolve the issue instantly. ## Benefits - Stop jumping between tabs. You can check a customer's subscription status or pull their full billing history instantly using `list_subscriptions` and `list_customers`. Your agent handles the lookup; you get the answer. - Run real-time sales reports without exporting data. Need to know total revenue from last month? Asking your agent to run `list_orders` provides immediate, structured insights for decision making. - Handle promotions instantly. You can create a new discount code with `create_discount` based on a conversation and apply it immediately when simulating a checkout using `create_checkout`. - Audit everything in one chat session. Reviewing all products or checking the status of abandoned carts via `list_checkouts` is as simple as asking your agent to compile the list. - Build sophisticated automation workflows. You can use this MCP's tools to check product details (`get_product`), confirm customer identity, and then initiate a secure checkout flow. ## How It Works The bottom line is that you talk to your AI agent, and it talks to Polar to get you the answer or complete the task. 1. Subscribe to this MCP and enter your Polar Personal Access Token. 2. Select your preferred AI client (Claude, Cursor, etc.) within the Vinkius Marketplace. 3. Ask your agent a natural language question like, 'Show me all active subscriptions for Jane Doe.' ## Frequently Asked Questions **How can I check if a customer has an active subscription using Polar MCP?** You use `list_subscriptions` and filter by the customer's email or name. This tool shows you their current status, billing period, and amount due. **Can I create a discount code with Polar MCP?** Yes, calling `create_discount` lets you define the coupon's code, whether it’s percentage or fixed money off, and set its duration immediately. **Is listing orders accurate for revenue tracking via Polar MCP?** The `list_orders` tool shows the customer, product, amount, currency, and payment status. This provides a clean record to track total sales and average order value. **What if I need to check multiple products in one checkout?** You use `create_checkout` and provide all the necessary product IDs. The tool then generates a single session URL that covers everything you specified for payment. **Does Polar MCP help with abandoned carts?** Yes, calling `list_checkouts` shows the status of sessions, letting you see which checkouts are currently open or have expired. This helps track potential lost revenue.