# Polar MCP by usefulapi

> Polar MCP by usefulapi is an MCP server. Products, customers, orders, subscriptions, benefits, revenue metrics and refunds. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/polar-sh/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/polar-sh
- **MCP Registry name:** io.usefulapi/polar-sh
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http polar-sh https://polar-sh.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://polar-sh.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "polar-sh": {
      "type": "http",
      "url": "https://polar-sh.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "polar-sh": {
      "serverUrl": "https://polar-sh.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "polar-sh": {
      "type": "http",
      "url": "https://polar-sh.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `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/.

## 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

---
Source: https://ai-powered.com/mcp/polar-mcp-by-usefulapi
