MCP-Server

polar-sh

io.usefulapi/polar-sh
Business & Betrieb Commerce & Retail Payments & Fintech Öffentlich und erreichbar MCP 2026-07-28

Was dieses MCP kann

Manages products, customers, checkout links, subscriptions, orders, benefits, usage metering, refunds, licensing, revenue metrics, and webhooks.

polar_cancel_subscription
Cancel a subscription
Cancel a subscription at the end of its current period. The customer keeps access until then. Polar: PATCH /v1/subscriptions/{id}.
Destruktiv
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['subscription_id'], 'properties': {'subscription_id': {'type': 'string', 'description': 'The subscription to cancel.'}, 'customer_cancellation_reason': {'type': 'string', 'description': 'Why the customer is leaving, for your churn reporting.'}, 'customer_cancellation_comment': {'type': 'string', 'description': "The customer's own words."}}}
polar_create_checkout_link
Create a checkout link
Create a reusable checkout URL for one or more products — the link you put in a page or an email. Polar: POST /v1/checkout-links/.
Destruktiv
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['products'], 'properties': {'label': {'type': 'string', 'description': 'An internal label for the link.'}, 'products': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Product ids the link sells.'}, 'discount_id': {'type': 'string', 'description': 'Apply this discount automatically.'}, 'success_url': {'type': 'string', 'description': 'Where to send the buyer after payment.'}, 'allow_discount_codes': {'type': 'boolean', 'description': 'Let the buyer enter a discount code. Defaults to true.'}}}
polar_create_refund
Refund an order
Refund an order, in full or in part. This moves real money back to the customer. Polar: POST /v1/refunds/.
Destruktiv
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['order_id', 'reason'], 'properties': {'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': "Amount in the currency's minor unit (cents). Omit to refund the full order."}, 'reason': {'enum': ['duplicate', 'fraudulent', 'customer_request', 'service_disruption', 'satisfaction_guarantee', 'other'], 'type': 'string', 'description': 'Why the refund is being issued.'}, 'comment': {'type': 'string', 'description': 'An internal note about the refund.'}, 'order_id': {'type': 'string', 'description': 'The order to refund.'}, 'revoke_benefits': {'type': 'boolean', 'description': 'Also revoke the benefits the order granted. Defaults to false.'}}}
polar_get_customer
Get one customer
Fetch a single customer by Polar id. Polar: GET /v1/customers/{id}.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['customer_id'], 'properties': {'customer_id': {'type': 'string', 'description': "The customer's Polar id."}}}
polar_get_customer_state
Get a customer's full state
Fetch everything about one customer in a single call — active subscriptions, granted benefits and entitlements. The best answer to 'what does this customer currently have?'. Polar: GET /v1/customers/{id}/state.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['customer_id'], 'properties': {'customer_id': {'type': 'string', 'description': "The customer's Polar id."}}}
polar_get_customer_state_by_external_id
Get a customer's state by your own id
Same as polar_get_customer_state, but looked up by YOUR external id rather than Polar's — the usual path when you hold your own user id. Polar: GET /v1/customers/external/{external_id}/state.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['external_id'], 'properties': {'external_id': {'type': 'string', 'description': 'Your own id for this customer.'}}}
polar_get_meter_quantities
Get a meter's quantities
Fetch the aggregated quantities a meter has recorded over a window — what usage-based billing will charge for. Polar: GET /v1/meters/{id}/quantities.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['meter_id', 'start_timestamp', 'end_timestamp', 'interval'], 'properties': {'interval': {'enum': ['hour', 'day', 'week', 'month', 'year'], 'type': 'string', 'description': 'Bucket size for the series.'}, 'meter_id': {'type': 'string', 'description': "The meter's id."}, 'customer_id': {'type': 'string', 'description': "Only this customer's usage."}, 'end_timestamp': {'type': 'string', 'description': 'ISO-8601 end of the window.'}, 'start_timestamp': {'type': 'string', 'description': 'ISO-8601 start of the window.'}}}
polar_get_metrics
Get revenue metrics
Fetch revenue and subscription metrics over a date range, bucketed by interval — orders, revenue, MRR, active subscriptions. Polar: GET /v1/metrics/.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['start_date', 'end_date', 'interval'], 'properties': {'end_date': {'type': 'string', 'description': 'End of the window, YYYY-MM-DD.'}, 'interval': {'enum': ['hour', 'day', 'week', 'month', 'year'], 'type': 'string', 'description': 'Bucket size for the series.'}, 'product_id': {'type': 'string', 'description': "Only this product's metrics."}, 'start_date': {'type': 'string', 'description': 'Start of the window, YYYY-MM-DD.'}, 'customer_id': {'type': 'string', 'description': "Only this customer's metrics."}, 'organization_id': {'type': 'string', 'description': 'Restrict to this organisation id. Needed when the token spans several organisations.'}}}
polar_get_order
Get one order
Fetch a single order with its line items, discount and tax. Polar: GET /v1/orders/{id}.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['order_id'], 'properties': {'order_id': {'type': 'string', 'description': "The order's id."}}}
polar_get_product
Get one product
Fetch a single product with its prices and attached benefits. Polar: GET /v1/products/{id}.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['product_id'], 'properties': {'product_id': {'type': 'string', 'description': "The product's id."}}}
polar_get_subscription
Get one subscription
Fetch a single subscription with its product, price and period. Polar: GET /v1/subscriptions/{id}.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['subscription_id'], 'properties': {'subscription_id': {'type': 'string', 'description': "The subscription's id."}}}
polar_list_benefit_grants
List grants of a benefit
List who has been granted one benefit, and whether the grant is still active. Polar: GET /v1/benefits/{id}/grants.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['benefit_id'], 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': '1-based page number.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size, 1-100.'}, 'benefit_id': {'type': 'string', 'description': "The benefit's id."}}}
polar_list_benefits
List benefits
List benefits — the things a product grants, such as licence keys, file downloads or Discord roles. Polar: GET /v1/benefits/.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': '1-based page number.'}, 'type': {'type': 'string', 'description': 'Only benefits of this type.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size, 1-100.'}, 'query': {'type': 'string', 'description': 'Free-text search.'}, 'organization_id': {'type': 'string', 'description': 'Restrict to this organisation id. Needed when the token spans several organisations.'}}}
polar_list_customers
List customers
List customers, optionally by email or a text query. Polar: GET /v1/customers/.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': '1-based page number.'}, 'email': {'type': 'string', 'description': 'Only the customer with this email.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size, 1-100.'}, 'query': {'type': 'string', 'description': 'Free-text search over name and email.'}, 'organization_id': {'type': 'string', 'description': 'Restrict to this organisation id. Needed when the token spans several organisations.'}}}
polar_list_discounts
List discounts
List discount codes and their redemption limits. Polar: GET /v1/discounts/.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': '1-based page number.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size, 1-100.'}, 'query': {'type': 'string', 'description': 'Free-text search over discount names and codes.'}, 'organization_id': {'type': 'string', 'description': 'Restrict to this organisation id. Needed when the token spans several organisations.'}}}
polar_list_events
List usage events
List the raw usage events ingested for metering, filtered by customer, meter, name or time. Polar: GET /v1/events/.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'name': {'type': 'string', 'description': 'Only events with this name.'}, 'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': '1-based page number.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size, 1-100.'}, 'meter_id': {'type': 'string', 'description': 'Only events matching this meter.'}, 'customer_id': {'type': 'string', 'description': "Only this customer's events."}, 'end_timestamp': {'type': 'string', 'description': 'ISO-8601 upper bound.'}, 'organization_id': {'type': 'string', 'description': 'Restrict to this organisation id. Needed when the token spans several organisations.'}, 'start_timestamp': {'type': 'string', 'description': 'ISO-8601 lower bound.'}}}
polar_list_license_keys
List licence keys
List issued licence keys and their status. Polar: GET /v1/license-keys/.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': '1-based page number.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size, 1-100.'}, 'status': {'type': 'string', 'description': 'Only keys in this state, e.g. granted, revoked, disabled.'}, 'benefit_id': {'type': 'string', 'description': 'Only keys from this benefit.'}, 'organization_id': {'type': 'string', 'description': 'Restrict to this organisation id. Needed when the token spans several organisations.'}}}
polar_list_meters
List usage meters
List the usage meters that aggregate events into billable quantities. Polar: GET /v1/meters/.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': '1-based page number.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size, 1-100.'}, 'organization_id': {'type': 'string', 'description': 'Restrict to this organisation id. Needed when the token spans several organisations.'}}}
polar_list_orders
List orders
List orders, filtered by customer, product, subscription, status or a date window. Polar: GET /v1/orders/.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': '1-based page number.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size, 1-100.'}, 'status': {'type': 'string', 'description': 'Only orders in this state, e.g. paid, pending, refunded.'}, 'product_id': {'type': 'string', 'description': 'Only orders for this product.'}, 'customer_id': {'type': 'string', 'description': "Only this customer's orders."}, 'created_after': {'type': 'string', 'description': 'ISO-8601 lower bound on creation time.'}, 'created_before': {'type': 'string', 'description': 'ISO-8601 upper bound on creation time.'}, 'organization_id': {'type': 'string', 'description': 'Restrict to this organisation id. Needed when the token spans several organisations.'}, 'subscription_id': {'type': 'string', 'description': 'Only orders from this subscription.'}}}
polar_list_organizations
List organisations
List the organisations the token can act for. Start here — most other tools take an organization_id. Polar: GET /v1/organizations/.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': '1-based page number.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size, 1-100.'}}}
polar_list_products
List products
List products, optionally filtered by archived state, recurrence or a text query. Polar: GET /v1/products/.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': '1-based page number.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size, 1-100.'}, 'query': {'type': 'string', 'description': 'Free-text search over product names.'}, 'is_archived': {'type': 'boolean', 'description': 'Only archived, or only live, products.'}, 'is_recurring': {'type': 'boolean', 'description': 'Only subscriptions, or only one-off products.'}, 'organization_id': {'type': 'string', 'description': 'Restrict to this organisation id. Needed when the token spans several organisations.'}}}
polar_list_refunds
List refunds
List refunds, filtered by order, subscription, customer or success. Polar: GET /v1/refunds/.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': '1-based page number.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size, 1-100.'}, 'order_id': {'type': 'string', 'description': 'Only refunds against this order.'}, 'succeeded': {'type': 'boolean', 'description': 'Only successful, or only failed, refunds.'}, 'customer_id': {'type': 'string', 'description': "Only this customer's refunds."}, 'organization_id': {'type': 'string', 'description': 'Restrict to this organisation id. Needed when the token spans several organisations.'}}}
polar_list_subscriptions
List subscriptions
List subscriptions, filtered by customer, product, status, active state or cancellation window. Polar: GET /v1/subscriptions/.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': '1-based page number.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size, 1-100.'}, 'active': {'type': 'boolean', 'description': 'Only active, or only inactive, subscriptions.'}, 'status': {'type': 'string', 'description': 'Only subscriptions in this state.'}, 'product_id': {'type': 'string', 'description': 'Only subscriptions to this product.'}, 'customer_id': {'type': 'string', 'description': "Only this customer's subscriptions."}, 'organization_id': {'type': 'string', 'description': 'Restrict to this organisation id. Needed when the token spans several organisations.'}, 'cancel_at_period_end': {'type': 'boolean', 'description': 'Only those already set to cancel — your churn pipeline.'}}}
polar_list_webhook_deliveries
List webhook deliveries
List webhook delivery attempts with their HTTP results — the tool for 'why did my webhook not arrive?'. Polar: GET /v1/webhooks/deliveries.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': '1-based page number.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size, 1-100.'}, 'succeeded': {'type': 'boolean', 'description': 'Only failures, or only successes.'}, 'event_type': {'type': 'string', 'description': 'Only deliveries of this event type.'}, 'endpoint_id': {'type': 'string', 'description': 'Only deliveries to this endpoint.'}, 'end_timestamp': {'type': 'string', 'description': 'ISO-8601 upper bound.'}, 'start_timestamp': {'type': 'string', 'description': 'ISO-8601 lower bound.'}}}
polar_list_webhook_endpoints
List webhook endpoints
List the configured webhook endpoints and their subscribed events. Polar: GET /v1/webhooks/endpoints.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': '1-based page number.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size, 1-100.'}, 'organization_id': {'type': 'string', 'description': 'Restrict to this organisation id. Needed when the token spans several organisations.'}}}
polar_redeliver_webhook_event
Redeliver a webhook event
Queue one webhook event for redelivery after your endpoint recovered. Polar: POST /v1/webhooks/events/{id}/redeliver.
Destruktiv
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['event_id'], 'properties': {'event_id': {'type': 'string', 'description': 'The webhook event to resend.'}}}
Hinzugefügt
polar_create_checkout_link
4. October 2026 02:40
Hinzugefügt
polar_cancel_subscription
4. October 2026 02:40
Hinzugefügt
polar_create_refund
4. October 2026 02:40
Hinzugefügt
polar_redeliver_webhook_event
4. October 2026 02:40
Hinzugefügt
polar_list_webhook_endpoints
4. October 2026 02:40
Hinzugefügt
polar_list_webhook_deliveries
4. October 2026 02:40
Hinzugefügt
polar_list_events
4. October 2026 02:40
Hinzugefügt
polar_get_meter_quantities
4. October 2026 02:40
Hinzugefügt
polar_list_meters
4. October 2026 02:40
Hinzugefügt
polar_list_license_keys
4. October 2026 02:40
Hinzugefügt
polar_list_refunds
4. October 2026 02:40
Hinzugefügt
polar_list_discounts
4. October 2026 02:40
Hinzugefügt
polar_list_benefit_grants
4. October 2026 02:40
Hinzugefügt
polar_list_benefits
4. October 2026 02:40
Hinzugefügt
polar_get_metrics
4. October 2026 02:40
Hinzugefügt
polar_get_subscription
4. October 2026 02:40
Hinzugefügt
polar_list_subscriptions
4. October 2026 02:40
Hinzugefügt
polar_get_order
4. October 2026 02:40
Hinzugefügt
polar_list_orders
4. October 2026 02:40
Hinzugefügt
polar_get_customer_state_by_external_id
4. October 2026 02:40
Hinzugefügt
polar_get_customer_state
4. October 2026 02:40
Hinzugefügt
polar_get_customer
4. October 2026 02:40
Hinzugefügt
polar_list_customers
4. October 2026 02:40
Hinzugefügt
polar_get_product
4. October 2026 02:40
Hinzugefügt
polar_list_products
4. October 2026 02:40
Hinzugefügt
polar_list_organizations
4. October 2026 02:40