Integration

Polar integration

Polar is a merchant-of-record billing platform for software products. Manage products and prices, checkout sessions and checkout links, customers (by Polar id or your external id), their state, members and seats, subscriptions, orders, invoices, refunds, disputes, payments, discounts, benefits and license keys; ingest usage events and read meters, metrics, CSV exports and webhook deliveries. Several tools move real money or access (refunds, charging a draft order, revoking a subscription): each one says so. Customer-facing portal routes, OAuth client management, browser checkout confirmation, file uploads and webhook secret resets are not exposed, and signing secrets, checkout client secrets, license keys in lists and webhook delivery payloads are left out of answers. Authentication is an Organization Access Token (organization settings) sent as Authorization: Bearer, with the environment chosen at connection: production (api.polar.sh) or the isolated sandbox (sandbox-api.polar.sh), each with its own tokens.

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Polar.Built from the 125 Polar tools below, on the connection you add once.

What you can do with Polar

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Member, 10 operations

  • create_customer_memberCreate customer memberPOSTAdds a member (person) to a team customer. Only B2B customers with member management enabled can have members.
  • create_member_by_external_idCreate member by external idPOSTAdds a member (person) to a team customer found by your external id, optionally with the member's own external id.
  • delete_customer_memberDelete customer memberDELETERemoves a member from a customer.
  • delete_member_by_external_idDelete member by external idDELETERemoves a member, by its external id, from a customer found by your external id.
  • get_customer_memberGet customer memberGETReturns one member of a customer.
  • get_member_by_external_idGet member by external idGETReturns one member, by its external id, of a customer found by your external id.
  • list_customer_membersList customer membersGETLists the members (people) of a team customer.
  • list_members_by_external_idList members by external idGETLists the members (people) of a team customer found by your external id.
  • update_customer_memberUpdate customer memberPATCHUpdates a member's name, email or role. Leave out what you keep.
  • update_member_by_external_idUpdate member by external idPATCHUpdates a member's name, email or role, both found by external ids. Leave out what you keep.

Benefit, 6 operations

  • create_benefitCreate benefitPOSTCreates a benefit that products can grant: license keys, downloadable files, Discord role, GitHub repository access, meter credits, feature flag, Slack channel or a custom note.
  • delete_benefitDelete benefitDELETEDeletes a benefit. Every grant of it is revoked at once, so customers lose access to it.
  • get_benefitGet benefitGETReturns one benefit by id with its type, description, visibility and type-specific properties.
  • list_benefitsList benefitsGETLists benefits (what a product grants: license keys, file downloads, Discord or GitHub access, meter credits, feature flags, custom notes), filterable by type or description.
  • set_product_benefitsSet product benefitsPOSTSets the full list of benefits a product grants (replaces the current list). Customers gain or lose benefits accordingly.
  • update_benefitUpdate benefitPATCHUpdates a benefit's description, visibility, metadata or type-specific properties. type must be the benefit's current type (read it with get_benefit). Leave out what you keep.

Checkout link, 5 operations

  • create_checkout_linkCreate checkout linkPOSTCreates a reusable checkout link for one or more products (products); share its url field. Each visit opens a new checkout session.
  • delete_checkout_linkDelete checkout linkDELETEDeletes a checkout link; its URL stops working.
  • get_checkout_linkGet checkout linkGETReturns one checkout link by id with its products, discount and url.
  • list_checkout_linksList checkout linksGETLists checkout links (reusable, shareable purchase URLs), filterable by product.
  • update_checkout_linkUpdate checkout linkPATCHUpdates a checkout link (products, label, discount, success URL, trial, seats or units). Leave out what you keep.

Custom field, 5 operations

  • create_custom_fieldCreate custom fieldPOSTCreates a custom field (text, number, date, checkbox or select) that products can ask for at checkout; its value is stored under its slug.
  • delete_custom_fieldDelete custom fieldDELETEDeletes a custom field.
  • get_custom_fieldGet custom fieldGETReturns one custom field by id.
  • list_custom_fieldsList custom fieldsGETLists the custom fields that checkouts can collect, filterable by name, slug or type.
  • update_custom_fieldUpdate custom fieldPATCHUpdates a custom field's name, slug, metadata or form properties. type must be the field's current type (read it with get_custom_field).

Customer, 5 operations

  • create_customerCreate customerPOSTCreates a customer. Set external_id to the customer's id in your system to read or update it later by that id.
  • delete_customerDelete customerDELETEDeletes a customer: cancels their active subscriptions, revokes their benefits and clears their external id, at once. Set anonymize=true to also anonymize personal data (GDPR). Cannot be undone.
  • get_customerGet customerGETReturns one customer by Polar id.
  • list_customersList customersGETLists customers, filterable by exact email, a name/email/external id search, active subscription or metadata.
  • update_customerUpdate customerPATCHUpdates a customer (email, name, billing address, tax id, locale, metadata, external id if unset, type individual to team). Leave out what you keep.

Dashboard, 5 operations

  • create_metric_dashboardCreate metric dashboardPOSTCreates a metric dashboard showing a list of metric slugs.
  • delete_metric_dashboardDelete metric dashboardDELETEDeletes a metric dashboard.
  • get_metric_dashboardGet metric dashboardGETReturns one metric dashboard by id.
  • list_metric_dashboardsList metric dashboardsGETLists your saved metric dashboards.
  • update_metric_dashboardUpdate metric dashboardPATCHRenames a metric dashboard or changes its metrics. Leave out what you keep.

Discount, 5 operations

  • create_discountCreate discountPOSTCreates a discount: fixed amount or percentage (basis_points), once, forever or for some months, optionally with a code customers type at checkout and redemption limits.
  • delete_discountDelete discountDELETEDeletes a discount; it can no longer be redeemed.
  • get_discountGet discountGETReturns one discount by id with its amount or percentage, duration, code, limits and redemption count.
  • list_discountsList discountsGETLists discounts, filterable by name.
  • update_discountUpdate discountPATCHUpdates a discount (name, code, dates, redemption limits, amount, products). Leave out what you keep.

Checkout, 4 operations

  • create_checkoutCreate checkoutPOSTCreates a checkout session for one or more products and returns its url for the customer to pay. Optionally prefill the customer, apply a discount or set an ad-hoc price.
  • get_checkoutGet checkoutGETReturns one checkout session by id: status, amounts, tax, currency, selected product and price, customer details and url.
  • list_checkoutsList checkoutsGETLists checkout sessions, filterable by product, customer, status (open, expired, confirmed, succeeded, failed) or customer email.
  • update_checkoutUpdate checkoutPATCHUpdates an open checkout session (product, amount, seats, units, customer details, discount, URLs). Leave out what you keep.

Endpoint, 4 operations

  • create_webhook_endpointCreate webhook endpointPOSTRegisters a webhook endpoint for a list of events. Polar generates the signing secret: copy it from the Polar dashboard (organization settings, Webhooks).
  • delete_webhook_endpointDelete webhook endpointDELETEDeletes a webhook endpoint; no more events are sent to it.
  • get_webhook_endpointGet webhook endpointGETReturns one webhook endpoint by id (signing secret not returned).
  • list_webhook_endpointsList webhook endpointsGETLists webhook endpoints (URL, format, subscribed events). Signing secrets are not returned.

Export, 4 operations

  • export_customers_csvExport customers csvGETExports the organization's customers as one CSV text, returned whole in csv (customer personal data). Use list_customers to page through them as structured records instead.
  • export_metrics_csvExport metrics csvGETExports metrics (revenue, orders, subscriptions and the other metric slugs) between two dates at a chosen interval as one CSV text, returned whole in csv. Leave out metrics to export all of them.
  • export_orders_csvExport orders csvGETExports orders as one CSV text, returned whole in csv, filterable by product, status and creation date; choose the columns and their order with columns (customer email and name columns are personal data).
  • export_subscriptions_csvExport subscriptions csvGETExports subscriptions as one CSV text, returned whole in csv, filterable by product, status, cancel at period end and start date; choose the columns with columns (customer email and name columns are personal data).

File, 4 operations

  • delete_fileDelete fileDELETEDeletes an uploaded file.
  • list_benefit_filesList benefit filesGETLists the downloadable files of a downloadables benefit, with download statistics.
  • list_filesList filesGETLists uploaded files (product media, downloadables, organization avatars).
  • update_fileUpdate filePATCHRenames a file or sets its version label. Leave out what you keep.

Meter, 4 operations

  • create_meterCreate meterPOSTCreates a meter: a filter on ingested events plus an aggregation (count, sum, max, min, avg, unique) that usage-based prices bill on.
  • get_meterGet meterGETReturns one meter by id with its filter and aggregation.
  • list_metersList metersGETLists meters (usage aggregations over ingested events), filterable by name or archived status.
  • update_meterUpdate meterPATCHUpdates a meter (name, unit, filter, aggregation) or archives it. Leave out what you keep.

Order, 4 operations

  • create_draft_orderCreate draft orderPOSTCreates a DRAFT order for an off-session charge of a one-time product to a customer's saved payment method. Nothing is charged until finalize_order.
  • get_orderGet orderGETReturns one order by id: status, amounts, tax, items, customer, product and subscription.
  • list_ordersList ordersGETLists orders, filterable by product, billing type, customer, checkout, subscription, discount, status or creation date.
  • update_orderUpdate orderPATCHUpdates the billing name or billing address (not country or state) printed on an order's invoice. Leave out what you keep.

Product, 4 operations

  • create_productCreate productPOSTCreates a product with its prices (fixed, pay what you want, free, seat-based, unit-based or metered). Set recurring_interval for a subscription product; leave it out for one-time.
  • delete_productDelete productDELETEDeletes a product. Only products with no orders, subscriptions, trials or discounts can be deleted; archive the others with update_product (is_archived).
  • get_productGet productGETReturns one product by id with its prices, benefits, medias and custom fields.
  • list_productsList productsGETLists products with their prices and benefits, filterable by name, archived, recurring, benefit, visibility or metadata.

Subscription, 4 operations

  • create_free_subscriptionCreate free subscriptionPOSTSubscribes a customer to a FREE recurring product. Paid products need a checkout (create_checkout). No order or confirmation email is created.
  • get_subscriptionGet subscriptionGETReturns one subscription by id: status, amount, interval, current period, cancellation and trial details, customer, product, discount.
  • list_subscriptionsList subscriptionsGETLists subscriptions, filterable by product, customer, discount, status, active, cancellation, start or cancel dates, or metadata.
  • revoke_subscriptionRevoke subscriptionDELETERevokes a subscription now: it is canceled immediately and its benefits are revoked.

Customer seat, 3 operations

  • assign_customer_seatAssign customer seatPOSTAssigns a seat of a seat-based subscription or order to a person by email, customer or member. Sends an invitation email unless immediate_claim is true.
  • list_customer_seatsList customer seatsGETLists the seats of a seat-based subscription or order (pass subscription_id or order_id), with available and total seat counts.
  • revoke_customer_seatRevoke customer seatDELETERevokes a customer seat; the person loses the seat's benefits.

External, 3 operations

  • delete_customer_by_external_idDelete customer by external idDELETEDeletes a customer by your external id: cancels their active subscriptions and revokes their benefits at once. Set anonymize=true to also anonymize personal data (GDPR).
  • get_customer_by_external_idGet customer by external idGETReturns one customer by your external id.
  • update_customer_by_external_idUpdate customer by external idPATCHUpdates a customer found by your external id (email, name, billing address, tax id, locale, metadata). Leave out what you keep.

License key, 3 operations

  • get_license_keyGet license keyGETReturns one license key by id, including the full key, status, usage, limits, expiry and activations.
  • list_license_keysList license keysGETLists license keys, filterable by benefit or status (granted, revoked, disabled). Keys are shown masked here; read one with get_license_key.
  • update_license_keyUpdate license keyPATCHUpdates a license key's status (granted, revoked, disabled), usage counter, limits or expiry. Leave out what you keep.

Customer meter, 2 operations

  • get_customer_meterGet customer meterGETReturns one customer meter by id: consumed units, credited units and balance, with the customer and the meter.
  • list_customer_metersList customer metersGETLists customer meters: per customer and meter, the consumed units, credited units and balance. Filter by customer or meter.

Dispute, 2 operations

  • get_disputeGet disputeGETReturns one dispute by id with its status, amount and order.
  • list_disputesList disputesGETLists payment disputes (chargebacks), filterable by order or status.

Event, 2 operations

  • get_eventGet eventGETReturns one event by id.
  • list_eventsList eventsGETLists usage and system events, filterable by customer, name, source, meter, time range or metadata.

Event type, 2 operations

  • list_event_typesList event typesGETLists the event types your organization has received, with aggregated statistics.
  • update_event_typeUpdate event typePATCHSets the display label of an event type, optionally taken from a property of each event.

Invoice, 2 operations

  • generate_order_invoiceGenerate order invoicePOSTStarts generating an order's invoice PDF (asynchronous); read it afterwards with get_order_invoice.
  • get_order_invoiceGet order invoiceGETReturns an order's invoice URL. Call generate_order_invoice first if it was never generated.

Organization, 2 operations

  • get_organizationGet organizationGETReturns one organization by id with its settings.
  • list_organizationsList organizationsGETLists the organizations the token can access (an organization token sees its own), filterable by slug.

Payment, 2 operations

  • get_paymentGet paymentGETReturns one payment by id.
  • list_paymentsList paymentsGETLists payments (charge attempts), filterable by checkout, order, customer, status, method or customer email.

Payment method, 2 operations

  • list_customer_payment_methodsList customer payment methodsGETLists a customer's saved payment methods (the ids finalize_order can charge).
  • list_payment_methods_by_external_idList payment methods by external idGETLists the saved payment methods of a customer found by your external id.

Refund, 2 operations

  • create_refundCreate refundPOSTRefunds part or all of an order (amount in cents) to the customer. Irreversible.
  • list_refundsList refundsGETLists refunds, filterable by order, subscription, customer or success.

State, 2 operations

  • get_customer_stateGet customer stateGETReturns a customer with their active subscriptions, granted benefits and meter balances: the full picture to decide what they can access.
  • get_customer_state_by_external_idGet customer state by external idGETReturns a customer found by your external id with their active subscriptions, granted benefits and meter balances: the full picture to decide access.

Accept, 1 operation

  • accept_disputeAccept disputePOSTAccepts a dispute, conceding the chargeback: it is closed as lost with the processor. Irreversible.

Activate, 1 operation

  • activate_license_keyActivate license keyPOSTActivates a license key for one device or instance (label) and returns the activation id; fails once the key's activation limit is reached.

Activation, 1 operation

  • get_license_key_activationGet license key activationGETReturns one activation of a license key.

Benefit grant, 1 operation

  • list_benefit_grantsList benefit grantsGETLists benefit grants (which customer was granted which benefit, and whether it is still granted) across all benefits, filterable by customer or granted status.

Customer session, 1 operation

  • create_customer_sessionCreate customer sessionPOSTCreates a customer portal session for a customer (by id or external id) and returns customer_portal_url to send them, plus a short-lived customer access token.

Deactivate, 1 operation

  • deactivate_license_keyDeactivate license keyPOSTRemoves one activation from a license key, freeing an activation slot.

Delivery, 1 operation

  • list_webhook_deliveriesList webhook deliveriesGETLists webhook delivery attempts (status, HTTP code, your endpoint's response, event type), filterable by endpoint, time range, success, HTTP code class or event type. The event payload itself is not returned.

Finalize, 1 operation

  • finalize_orderFinalize orderPOSTFinalizes a draft order and charges the customer's saved payment method now. On success the order is paid and benefits are granted; on failure it stays draft.

Grant, 1 operation

  • list_grants_of_benefitList grants of benefitGETLists the grants of one benefit; use it to check whether a given customer has been granted that benefit.

Ingest, 1 operation

  • ingest_eventsIngest eventsPOSTSends a batch of usage events (name, customer, timestamp, metadata) that meters aggregate. Customers on usage-based (metered) prices are billed for the usage these events record.

Limit, 1 operation

  • get_metrics_limitsGet metrics limitsGETReturns the allowed date range and the maximum span per interval for get_metrics.

Metric, 1 operation

  • get_metricsGet metricsGETReturns revenue, order and subscription metrics (MRR, revenue, active subscriptions, checkouts...) per interval between two dates. Amounts are in cents.

Name, 1 operation

  • list_event_namesList event namesGETLists the distinct event names received, filterable by customer and source.

Quantity, 1 operation

  • get_meter_quantitiesGet meter quantitiesGETReturns a meter's aggregated quantity per interval between two timestamps, optionally for one customer.

Receipt, 1 operation

  • get_order_receiptGet order receiptGETReturns a presigned URL to download an order's receipt PDF.

Redeliver, 1 operation

  • redeliver_webhook_eventRedeliver webhook eventPOSTSchedules a new delivery of a past webhook event to its endpoint.

Resend, 1 operation

  • resend_seat_invitationResend seat invitationPOSTSends the invitation email of a pending customer seat again.

Rotate, 1 operation

  • rotate_license_keyRotate license keyPOSTGenerates a new key string for a license key and returns it; the previous string stops validating at once. Status, usage, limits, expiry and activations are kept.

Showing the first 120 of 125 endpoints. The rest are in the product, searchable from the workflow builder and from chat.

Use Polar from Claude Code, Cursor or Codex

Connect Polar in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Polar operations become tools the client can call, next to every other integration you connected.

Claude Code
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"
Codex (~/.codex/config.toml)
[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"
Cursor, Claude Desktop and other JSON configs
{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Polar

  1. Create your workspace

    Sign up free. Nothing to install.

  2. Connect Polar once

    Add your Polar connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.

  3. Describe the job in chat

    The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.

Polar integration FAQ

What can you do with the Polar integration?

LiveContext exposes 125 operations on Polar, covering member, benefit, checkout link and custom field.

Popular integrations

Browse the whole catalog