MCP server
Polar MCP by usefulapi
Products, customers, orders, subscriptions, benefits, revenue metrics and refunds.
- Runs
- Remotely
- Version
- 1.40.0
- Listing updated
- 4 days ago
About Polar MCP by usefulapi
Polar MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Install
Run in a terminal
claude mcp add --transport http polar-sh https://polar-sh.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://polar-sh.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"polar-sh": {
"url": "https://polar-sh.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"polar-sh": {
"type": "http",
"url": "https://polar-sh.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"polar-sh": {
"serverUrl": "https://polar-sh.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"polar-sh": {
"type": "http",
"url": "https://polar-sh.usefulapi.io/mcp"
}
}
}Tools this server provides (26)
Read directly from the server.
- polar_list_organizations
- List the organisations the token can act for. Start here — most other tools take an organization_id. Polar: GET /v1/organizations/.
- polar_list_products
- List products, optionally filtered by archived state, recurrence or a text query. Polar: GET /v1/products/.
- polar_get_product
- Fetch a single product with its prices and attached benefits. Polar: GET /v1/products/{id}.
- polar_list_customers
- List customers, optionally by email or a text query. Polar: GET /v1/customers/.
- polar_get_customer
- Fetch a single customer by Polar id. Polar: GET /v1/customers/{id}.
- polar_get_customer_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
- 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
- List orders, filtered by customer, product, subscription, status or a date window. Polar: GET /v1/orders/.
- polar_get_order
- Fetch a single order with its line items, discount and tax. Polar: GET /v1/orders/{id}.
- polar_list_subscriptions
- List subscriptions, filtered by customer, product, status, active state or cancellation window. Polar: GET /v1/subscriptions/.
- polar_get_subscription
- Fetch a single subscription with its product, price and period. Polar: GET /v1/subscriptions/{id}.
- polar_get_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
- List benefits — the things a product grants, such as licence keys, file downloads or Discord roles. Polar: GET /v1/benefits/.
- polar_list_benefit_grants
- List who has been granted one benefit, and whether the grant is still active. Polar: GET /v1/benefits/{id}/grants.
- polar_list_discounts
- List discount codes and their redemption limits. Polar: GET /v1/discounts/.
- polar_list_refunds
- List refunds, filtered by order, subscription, customer or success. Polar: GET /v1/refunds/.
- polar_list_license_keys
- List issued licence keys and their status. Polar: GET /v1/license-keys/.
- polar_list_meters
- List the usage meters that aggregate events into billable quantities. Polar: GET /v1/meters/.
- polar_get_meter_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
- List the raw usage events ingested for metering, filtered by customer, meter, name or time. Polar: GET /v1/events/.
- polar_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
- List the configured webhook endpoints and their subscribed events. Polar: GET /v1/webhooks/endpoints.
- polar_redeliver_webhook_event
- Queue one webhook event for redelivery after your endpoint recovered. Polar: POST /v1/webhooks/events/{id}/redeliver.
- polar_create_refund
- Refund an order, in full or in part. This moves real money back to the customer. Polar: POST /v1/refunds/.
- polar_cancel_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
- 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/.
Polar MCP by usefulapi FAQ
How do I add Polar MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http polar-sh https://polar-sh.usefulapi.io/mcp