Skip to content
MCP server

Polar MCP by usefulapi

Products, customers, orders, subscriptions, benefits, revenue metrics and refunds.

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://polar-sh.usefulapi.io/mcp
Install 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