usefulapi

Polar MCP server. Products, customers, orders, subscriptions, benefits, revenue metrics and refunds.

Claude

Open Settings → Connectors → Add custom connector
Paste this URL:
https://polar-sh.usefulapi.io/mcp
Authenticate with Polar when prompted

Cursor · VS Code · Windsurf · Cline

Add to your MCP config, then reload & authorize:

{
  "mcpServers": {
    "polar-sh": {
      "url": "https://polar-sh.usefulapi.io/mcp"
    }
  }
}

live26 toolsFree 100 tool calls / monthPro $9/mo · $90/yr

Tools 26

Tool	Type	What it does
`polar_list_organizations`	read	List organisations List the organisations the token can act for. Start here — most other tools take an organization_id. Polar: GET /v1/organizations/.
`polar_list_products`	read	List products List products, optionally filtered by archived state, recurrence or a text query. Polar: GET /v1/products/.
`polar_get_product`	read	Get one product Fetch a single product with its prices and attached benefits. Polar: GET /v1/products/{id}.
`polar_list_customers`	read	List customers List customers, optionally by email or a text query. Polar: GET /v1/customers/.
`polar_get_customer`	read	Get one customer Fetch a single customer by Polar id. Polar: GET /v1/customers/{id}.
`polar_get_customer_state`	read	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.
`polar_get_customer_state_by_external_id`	read	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.
`polar_list_orders`	read	List orders List orders, filtered by customer, product, subscription, status or a date window. Polar: GET /v1/orders/.
`polar_get_order`	read	Get one order Fetch a single order with its line items, discount and tax. Polar: GET /v1/orders/{id}.
`polar_list_subscriptions`	read	List subscriptions List subscriptions, filtered by customer, product, status, active state or cancellation window. Polar: GET /v1/subscriptions/.
`polar_get_subscription`	read	Get one subscription Fetch a single subscription with its product, price and period. Polar: GET /v1/subscriptions/{id}.
`polar_get_metrics`	read	Get revenue metrics Fetch revenue and subscription metrics over a date range, bucketed by interval — orders, revenue, MRR, active subscriptions. Polar: GET /v1/metrics/.
`polar_list_benefits`	read	List benefits List benefits — the things a product grants, such as licence keys, file downloads or Discord roles. Polar: GET /v1/benefits/.
`polar_list_benefit_grants`	read	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.
`polar_list_discounts`	read	List discounts List discount codes and their redemption limits. Polar: GET /v1/discounts/.
`polar_list_refunds`	read	List refunds List refunds, filtered by order, subscription, customer or success. Polar: GET /v1/refunds/.
`polar_list_license_keys`	read	List licence keys List issued licence keys and their status. Polar: GET /v1/license-keys/.
`polar_list_meters`	read	List usage meters List the usage meters that aggregate events into billable quantities. Polar: GET /v1/meters/.
`polar_get_meter_quantities`	read	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.
`polar_list_events`	read	List usage events List the raw usage events ingested for metering, filtered by customer, meter, name or time. Polar: GET /v1/events/.
`polar_list_webhook_deliveries`	read	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.
`polar_list_webhook_endpoints`	read	List webhook endpoints List the configured webhook endpoints and their subscribed events. Polar: GET /v1/webhooks/endpoints.
`polar_redeliver_webhook_event`	write	Redeliver a webhook event Queue one webhook event for redelivery after your endpoint recovered. Polar: POST /v1/webhooks/events/{id}/redeliver.
`polar_create_refund`	write	Refund an order Refund an order, in full or in part. This moves real money back to the customer. Polar: POST /v1/refunds/.
`polar_cancel_subscription`	write	Cancel a subscription Cancel a subscription at the end of its current period. The customer keeps access until then. Polar: PATCH /v1/subscriptions/{id}.
`polar_create_checkout_link`	write	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/.

Pricing

Plan	Price	Limit
Free	$0	100 tool calls / month
Pro	$9/mo · $90/yr	Unlimited

This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.