# Polar.sh MCP for AI Agents AI Agent Connect

> Polar.sh lets you manage your open-source monetization and SaaS billing directly through your AI agent. Instead of jumping between tabs to handle products, orders, and subscriptions, you can just ask your agent to do the work for you. It handles the business side of your developer projects so you can stay focused on your code.

## 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

Polar.sh lets you manage your open-source monetization and SaaS billing directly through your AI agent. Instead of constantly switching tabs to handle the business side of your software, you can just ask your agent to do it for you. This Connector handles the tedious parts of your developer business, like creating new digital products, checking on sales, or managing customer subscriptions. If you need to grant a community member a free tier or revoke access from someone who's no longer active, you just tell the agent. It pulls the data from your Polar account and handles the updates in the background. It's a way to keep your focus on shipping code while the agent takes care of the invoices and product listings. You'll find this is a core part of the Vinkius catalog for anyone trying to turn a side project into a real business without the administrative headache.

## Tools

### create_checkout
Creates a new checkout session. This starts a payment process for a customer ready to buy.

### revoke_subscription
Revokes a subscription immediately. Use this to cancel access when a user's status changes.

### create_benefit
Creates a new benefit for a product. This helps you define what customers get when they buy your goods.

### create_customer_session
Generates a customer session token. Use this to initiate a secure session for a customer.

### create_customer
Creates a new customer record. This adds a new user to your billing system automatically.

### create_product
Creates a new product in your account. Use this to launch new digital goods or subscription tiers.

### create_subscription
Creates a new subscription for free products. This is great for giving out free community access.

### create_webhook_endpoint
Creates a new webhook endpoint. Use this to send event notifications to your own backend services.

### delete_benefit
Deletes a benefit from a product. This also revokes all associated grants to your customers.

### generate_invoice
Generates an invoice for a specific order. This creates a professional billing document for your customers.

### get_benefit
Gets specific benefit details. Use this to check what features are tied to a certain product.

### get_checkout
Gets session details for a checkout. This helps you see where customers are in the buying process.

### get_customer_state
Gets a full overview of a customer's active subscriptions and benefits. Use this for quick support checks.

### get_invoice
Retrieves data for a generated invoice. Use this to pull specific billing details for a customer.

### get_order
Gets specific order details. This is useful for looking up transaction history or billing issues.

### get_portal_me
Gets authenticated customer info. Use this to see the details of the current user in the portal.

### get_product
Gets specific product details. Use this to pull information about a digital good or subscription.

### get_subscription
Gets specific subscription details. Use this to check the status of a user's recurring payment.

### list_benefits
Lists all benefits in your account. Use this to see every perk available across your products.

### list_checkouts
Lists all checkout sessions. This gives you a bird's-eye view of current purchase attempts.

### list_customers
Lists all customers in your account. Use this to see your total user base at a glance.

### list_orders
Lists all orders in your account. This helps you monitor your recent sales volume.

### list_portal_benefit_grants
Lists benefits granted to a specific customer. Use this to verify what a user has access to.

### list_portal_license_keys
Lists license keys for a customer. Use this to manage software keys for your users.

### list_portal_orders
Lists orders for a specific customer. Use this to show a user their personal purchase history.

### list_portal_subscriptions
Lists subscriptions for a specific customer. Use this to show a user their active plans.

### list_products
Lists products with filters like organization ID. Use this to see your full catalog of digital goods.

### list_subscriptions
Lists all subscriptions in your account. Use this to see every active recurring plan.

### list_webhook_deliveries
Lists and monitors webhook deliveries. Use this to debug why your backend isn't receiving events.

### update_checkout
Updates an existing checkout session. Use this to modify session details on the fly.

### update_order
Updates an order with new details. Use this to correct billing info or other order data.

### update_product_benefits
Updates the benefits granted by a product. Use this to change what your products offer.

### update_product
Updates details for a specific product. Use this to change pricing or descriptions for your goods.

### update_subscription
Updates an existing subscription. Use this to change a user's plan or billing cycle.

### validate_portal_license_key
Validates a license key. Use this to check if a user's key is still active and valid.

### confirm_checkout_client
Confirms a session from the client side. Use this to finalize a customer purchase without manual UI interaction.

## Prompt Examples

**Prompt:** 
```
List all my active products on Polar.
```

**Response:** 
```
I've retrieved your products. You have 3 active items:

| Product Name | ID | Status |
| :--- | :--- | :--- |
| **Developer Pro** | `prod_1` | Active |
| **Sponsorship** | `prod_2` | Active |
| **API Access** | `prod_3` | Active |

Would you like to see the details for any of these?
```

**Prompt:** 
```
Get the details for order ID 'ord_123' and generate an invoice.
```

**Response:** 
```
Order **ord_123** was placed by `user@example.com` for **$50.00**.

I have successfully triggered the action to generate a professional invoice for this order. You can now retrieve the invoice data whenever you need it.
```

**Prompt:** 
```
Revoke subscription 'sub_999' immediately.
```

**Response:** 
```
I have successfully revoked subscription **sub_999**. The customer's access to the associated product benefits has been terminated.
```

## Capabilities

### Create new products
Add new digital goods or recurring pricing models to your account.

### Generate customer invoices
Create professional invoices for specific orders using natural language.

### Manage subscriptions
Revoke, create, or update customer subscriptions instantly.

### Track checkout sessions
Monitor your conversion funnel by inspecting active checkout sessions.

### Grant product benefits
Assign specific benefits or access to your customers and community members.

## Use Cases

### Granting free access to a contributor
A maintainer wants to give a top contributor free access to their pro tool. They ask the agent to use `create_subscription` to add the user to the free tier.

### Checking MRR and sales history
A founder wants to see how many orders came in today. They ask the agent to use `list_orders` and summarize the total revenue.

### Updating a product's pricing
A developer needs to change the price of their sponsorship tier. They ask the agent to use `update_product` to modify the cost and description.

### Fixing a customer's billing details
A user reports an issue with their order. The founder asks the agent to use `get_order` to find the record and `update_order` to fix the billing info.

## Benefits

- Stop jumping between tabs to manage your business. Use `list_products` and `create_product` to handle your catalog directly through your AI client.
- Handle customer support faster. Use `get_customer_state` and `list_portal_subscriptions` to see exactly what a user owns without manual searching.
- Automate your billing tasks. Use `generate_invoice` to create professional documents for customers and `get_invoice` to pull their data instantly.
- Manage community access with ease. Use `create_subscription` to grant free tiers or `revoke_subscription` to cut off access in one step.
- Monitor your growth in real time. Use `list_orders` and `list_checkouts` to keep a pulse on your sales and conversion rates.
- Keep your developer workflow clean. Use `create_webhook_endpoint` and `list_webhook_deliveries` to manage your backend integrations without leaving your editor.

## How It Works

The bottom line is you get to handle your entire billing backend through a simple chat interface.

1. Subscribe to this Connector and connect it to your AI client.
2. Provide your Polar Personal Access Token to authenticate your account.
3. Ask your agent to perform tasks like listing products or revoking a subscription.

## Frequently Asked Questions

**Can I use the Polar.sh MCP to manage my open-source sponsorship program?**
Yes. You can use it to list products, check on orders, and manage the benefits you offer to your sponsors all through your AI agent.

**How does the Polar.sh MCP handle customer subscriptions?**
It allows your agent to see active subscriptions, update them, or revoke them immediately when a user's status changes.

**Can the Polar.sh MCP help me create new digital products?**
Yes. You can ask your agent to create new products, set up recurring pricing, and define the benefits for each one.

**Is the Polar.sh MCP good for managing open-source donations?**
It is perfect for this. You can monitor orders in real time and handle the billing side of your community support without leaving your editor.

**Can I use the Polar.sh MCP to issue invoices for my users?**
Yes. The Connector can generate professional invoices for specific orders so you can provide them to your customers instantly.

**Does the Polar.sh MCP support revoking access for subscribers?**
Yes. It can immediately revoke a subscription, which terminates the user's access to the associated product benefits.

**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.