# Polar.sh MCP for AI Agents AI Agent Connect > Polar.sh MCP lets you manage your open-source monetization and SaaS billing through your AI agent. You can create products, handle subscriptions, and track orders without leaving your editor. It's built for developers who want to turn their projects into businesses without the overhead of manual dashboard management. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_2xBSLfjaSzrr0NJNtiRStZJgJCflDAP6Y0smrMfH/ai-agent-connect - **Tags:** monetization, open-source, saas-billing, subscription-management, developer-economy ## Description Managing a developer business usually means juggling dozens of tabs. You're constantly switching between your code editor, your billing dashboard, and your customer support emails to check on subscriptions or update pricing. This Connector changes that by bringing your Polar.sh account directly into your AI client. Instead of digging through a web UI, you can just tell your agent to list your active products, create a new subscription for a community member, or pull up an invoice for a specific order. It's about staying in your flow state while handling the administrative side of your work. You might be an open-source maintainer looking to set up a sponsorship program, or you could be a SaaS founder tracking your monthly recurring revenue. This tool lets you handle the business part of your project through natural language. You can find this and thousands of other tools in the Vinkius catalog, making it easy to connect your entire tech stack to your agent in one go. ## Tools ### create_checkout Create a new checkout session. This initiates the payment flow for a new customer. ### revoke_subscription Revoke or cancel a subscription immediately. This is the fastest way to stop access to a product. ### create_benefit Create a new benefit for your products. This allows you to define specific rewards for your users. ### create_customer_session Generate a customer session token. This is useful for maintaining active user states. ### create_customer Create a new customer record. This adds a new user to your billing system. ### create_product Create a new product or digital good. Use this to expand your monetization offerings. ### create_subscription Create a new subscription for free products. This is ideal for granting community access. ### create_webhook_endpoint Create a new webhook endpoint. This allows you to send real-time data to your own services. ### delete_benefit Delete a benefit and revoke all associated grants. This cleans up your product offerings. ### generate_invoice Generate an invoice for a specific order. This creates a professional billing document for your client. ### get_benefit Get benefit details. This shows you exactly what rewards are attached to your products. ### get_checkout Get session details. This helps you inspect a specific checkout in progress. ### get_customer_state Get full overview of customer active subscriptions and benefits. This is great for support. ### get_invoice Retrieve generated invoice data. Use this to find the details of a specific billing record. ### get_order Get order details. This shows you the full history of a specific transaction. ### get_portal_me Get authenticated customer info. This retrieves the profile of the current user. ### get_product Get product details. This retrieves the full specifications of a specific item. ### get_subscription Get subscription details. This shows the status and history of a specific plan. ### list_benefits List benefits. This shows all the rewards you have currently available. ### list_checkouts List checkout sessions. This helps you monitor your current conversion funnel. ### list_customers List customers. This gives you a full directory of everyone who has interacted with your store. ### list_orders List orders. This shows you a history of all transactions made on your account. ### list_portal_benefit_grants List benefits granted to the customer. This shows what a specific user is currently allowed to access. ### list_portal_license_keys List customer license keys. This retrieves the keys associated with a specific user's account. ### list_portal_orders List customer orders. This shows the purchase history for a specific user. ### list_portal_subscriptions List customer subscriptions. This shows all the plans a specific user is currently enrolled in. ### list_products List products. This allows you to filter your catalog by organization or recurrence type. ### list_subscriptions List subscriptions. This shows every active plan across your entire account. ### list_webhook_deliveries List and monitor webhook deliveries. This helps you debug your integrations. ### update_checkout Update a session. This allows you to modify details of a checkout that is currently in progress. ### update_order Update order details. This is used to change billing information or other transaction data. ### update_product_benefits Update benefits granted by a product. This lets you change what users get from specific items. ### update_product Update a product. This lets you change the name, description, or price of an existing item. ### update_subscription Update a subscription. This allows you to modify the details of an existing user plan. ### validate_portal_license_key Validate a license key. This checks if a specific key is still active and valid for a user. ### confirm_checkout_client Confirm a session from the client side. This helps finalize the purchase process for your users. ## Prompt Examples **Prompt:** ``` Show me my current products and tell me which ones are recurring. ``` **Response:** ``` I've pulled up your product list. Here is what you have currently active: | Product Name | ID | Recurring | | :--- | :--- | :--- | | Pro Plan | `prod_882` | Yes | | Basic Tier | `prod_112` | No | | Community Access | `prod_009` | No | Would you like to see the details for any of these? ``` **Prompt:** ``` I need to send an invoice for order ord_998. Can you do that? ``` **Response:** ``` I've located order `ord_998`. It was for **$49.00** paid via credit card. I've triggered the invoice generation now. You can find the data for that invoice in your records shortly. ``` **Prompt:** ``` Give the user 'dev_user_1' a free subscription to the Pro plan. ``` **Response:** ``` I've updated the records for **dev_user_1**. They now have an active free subscription to the Pro plan. Their access to the associated benefits has been updated. ``` ## Capabilities ### Create and update digital products Add new items to your catalog or modify existing pricing and benefits. ### Generate invoices for specific orders Create professional billing documents for your customers via a simple request. ### Manage customer subscriptions and access Grant free tiers or revoke access to product benefits immediately. ### Track checkout sessions for conversion data Inspect active sessions to understand how users are moving through your sales funnel. ### Grant specific benefits to community members Assign rewards and features to contributors without manual database entries. ## Use Cases ### Adding a new sponsorship tier A maintainer needs to add a new sponsorship tier. They ask the agent to use `create_product` to set up the new tier and check the current lineup. ### Resolving access issues A customer claims they can't access a feature. The founder asks the agent to use `update_order` to check the transaction status and see if a refund is needed. ### Sending a purchase receipt A user wants a receipt for their purchase. The founder asks the agent to use `get_invoice` to pull the PDF. ### Granting contributor access A contributor wants a free license. The DevRel manager asks the agent to use `list_portal_subscriptions` to see what they already have. ## Benefits - Stop switching tabs by managing products and orders directly in your editor using `list_products` and `get_order`. - Handle customer support faster by using `revoke_subscription` and `get_customer_state` to manage access instantly. - Automate your billing workflow by using `generate_invoice` to create professional documents for your clients. - Scale your community rewards by using `create_benefit` and `create_subscription` to grant free access to contributors. - Gain better conversion insights by using `list_checkouts` to see how users are moving through your sales funnel. ## How It Works The bottom line is you get a natural language interface for your entire Polar.sh billing and product suite. 1. Subscribe to the Polar.sh MCP via the Vinkius catalog. 2. Add your Polar Personal Access Token to your AI client settings. 3. Ask your agent to list products, manage subscribers, or generate invoices. ## Frequently Asked Questions **What is the Polar.sh MCP for?** It lets you manage your Polar.sh products, subscriptions, and invoices directly through your AI agent. You can handle your billing and monetization tasks using natural language instead of clicking through a dashboard. **Can I use it to manage my open-source sponsorships?** Yes. It handles the listing and updating of products, which is exactly how you manage sponsorships and digital goods for your community. **How do I grant a free subscription to a contributor?** You can simply ask your agent to grant a free subscription to a specific user. The Connector handles the creation of that subscription for you instantly. **Can my agent generate invoices for me?** Yes, it can. Your agent can pull specific order details and generate a professional invoice for your customers on the fly. **Can I use this to revoke a user's access?** Yes. If a user needs to be removed or their access needs to be cut off, your agent can revoke their subscription immediately. **Does this work with Cursor or Claude?** Yes, it works with any MCP-compatible client, including Claude, Cursor, Windsurf, and VS Code. **Can I cancel a user's subscription through the AI?** Yes, you can use the `revoke_subscription` tool by providing the specific Subscription ID to terminate access immediately. **How do I generate an invoice for a specific order?** Simply use the `generate_invoice` tool with the Order ID. The agent will trigger the invoice generation process on Polar.sh. **Is it possible to update the benefits of an existing product?** Yes, the `update_product_benefits` tool allows you to modify the array of benefit IDs associated with any of your products.