# io.usefulapi/polar-sh (remote · polar-sh.usefulapi.io)

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

- Trust score: 78/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-10-03

## Components

- remote · `polar-sh.usefulapi.io`: 78/100 (this document), [markdown](https://verifymcp.io/servers/io-usefulapi-polar-sh/polar-sh.md), [page](https://verifymcp.io/servers/io-usefulapi-polar-sh/polar-sh)

## Channel facts

- Endpoint: `https://polar-sh.usefulapi.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-10-03.

- **Endpoint Security**: 89/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
  - The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 82/100
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 2525 tokens (~97/item across 26 items; 26 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 10/100
  - Stability observed for 3 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - All 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 26 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 60/100
  - Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28.

## Install

### How do I install the io.usefulapi/polar-sh MCP server?

io.usefulapi/polar-sh is a hosted endpoint at https://polar-sh.usefulapi.io/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

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

### Cursor

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

### VS Code

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

### Codex

```toml
[mcp_servers.io-usefulapi-polar-sh]
url = "https://polar-sh.usefulapi.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-usefulapi-polar-sh": {
      "type": "remote",
      "url": "https://polar-sh.usefulapi.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-usefulapi-polar-sh --url 'https://polar-sh.usefulapi.io/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-usefulapi-polar-sh:
    url: "https://polar-sh.usefulapi.io/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "io-usefulapi-polar-sh": {
      "Transport": "http",
      "Url": "https://polar-sh.usefulapi.io/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add io-usefulapi-polar-sh -t streamable-http -u 'https://polar-sh.usefulapi.io/mcp'
```

### Other

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

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-02 (score 78, +1)

- [functional] Server version: 1.3.0 → 1.5.1

### 2026-10-01 (score 77, +5)

- [security improvement] HTTPS: unverified → pass
- [functional improvement] Stability: unverified → 0.03
- [functional] Server version: 1.0.0 → 1.3.0

### 2026-09-30 (score 72, +54)

- [security improvement] Authorization: unverified → pass
- [security improvement] Injection markers: unverified → pass
- [security improvement] Transport: fail → pass
- [security] First check of Judged manipulation: pass
- [security] First check of Authorization: partial
- [functional regression] MCP protocol: unverified → fail
- [functional improvement] Tool coverage: unverified → 100
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: excellent
- [functional] First check of Destructive annotations: 100
- [functional] First check of Schema quality: pass
- [functional] First check of Tool coverage: 100

### 2026-09-29 (score 18)

First indexed and scored.

## MCP tools (26)

### `polar_list_organizations` (~65 tokens)

List organisations

List the organisations the token can act for. Start here — most other tools take an organization_id. Polar: GET /v1/organizations/.

Input parameters:

- `limit` (integer): Page size, 1-100.
- `page` (integer): 1-based page number.

### `polar_list_products` (~127 tokens)

List products

List products, optionally filtered by archived state, recurrence or a text query. Polar: GET /v1/products/.

Input parameters:

- `is_archived` (boolean): Only archived, or only live, products.
- `is_recurring` (boolean): Only subscriptions, or only one-off products.
- `limit` (integer): Page size, 1-100.
- `organization_id` (string): Restrict to this organisation id. Needed when the token spans several organisations.
- `page` (integer): 1-based page number.
- `query` (string): Free-text search over product names.

### `polar_get_product` (~42 tokens)

Get one product

Fetch a single product with its prices and attached benefits. Polar: GET /v1/products/{id}.

Input parameters:

- `product_id` (string, required): The product's id.

### `polar_list_customers` (~105 tokens)

List customers

List customers, optionally by email or a text query. Polar: GET /v1/customers/.

Input parameters:

- `email` (string): Only the customer with this email.
- `limit` (integer): Page size, 1-100.
- `organization_id` (string): Restrict to this organisation id. Needed when the token spans several organisations.
- `page` (integer): 1-based page number.
- `query` (string): Free-text search over name and email.

### `polar_get_customer` (~40 tokens)

Get one customer

Fetch a single customer by Polar id. Polar: GET /v1/customers/{id}.

Input parameters:

- `customer_id` (string, required): The customer's Polar id.

### `polar_get_customer_state` (~67 tokens)

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.

Input parameters:

- `customer_id` (string, required): The customer's Polar id.

### `polar_get_customer_state_by_external_id` (~73 tokens)

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.

Input parameters:

- `external_id` (string, required): Your own id for this customer.

### `polar_list_orders` (~175 tokens)

List orders

List orders, filtered by customer, product, subscription, status or a date window. Polar: GET /v1/orders/.

Input parameters:

- `created_after` (string): ISO-8601 lower bound on creation time.
- `created_before` (string): ISO-8601 upper bound on creation time.
- `customer_id` (string): Only this customer's orders.
- `limit` (integer): Page size, 1-100.
- `organization_id` (string): Restrict to this organisation id. Needed when the token spans several organisations.
- `page` (integer): 1-based page number.
- `product_id` (string): Only orders for this product.
- `status` (string): Only orders in this state, e.g. paid, pending, refunded.
- `subscription_id` (string): Only orders from this subscription.

### `polar_get_order` (~44 tokens)

Get one order

Fetch a single order with its line items, discount and tax. Polar: GET /v1/orders/{id}.

Input parameters:

- `order_id` (string, required): The order's id.

### `polar_list_subscriptions` (~156 tokens)

List subscriptions

List subscriptions, filtered by customer, product, status, active state or cancellation window. Polar: GET /v1/subscriptions/.

Input parameters:

- `active` (boolean): Only active, or only inactive, subscriptions.
- `cancel_at_period_end` (boolean): Only those already set to cancel — your churn pipeline.
- `customer_id` (string): Only this customer's subscriptions.
- `limit` (integer): Page size, 1-100.
- `organization_id` (string): Restrict to this organisation id. Needed when the token spans several organisations.
- `page` (integer): 1-based page number.
- `product_id` (string): Only subscriptions to this product.
- `status` (string): Only subscriptions in this state.

### `polar_get_subscription` (~44 tokens)

Get one subscription

Fetch a single subscription with its product, price and period. Polar: GET /v1/subscriptions/{id}.

Input parameters:

- `subscription_id` (string, required): The subscription's id.

### `polar_get_metrics` (~134 tokens)

Get revenue metrics

Fetch revenue and subscription metrics over a date range, bucketed by interval — orders, revenue, MRR, active subscriptions. Polar: GET /v1/metrics/.

Input parameters:

- `customer_id` (string): Only this customer's metrics.
- `end_date` (string, required): End of the window, YYYY-MM-DD.
- `interval` (string, required): Bucket size for the series.
- `organization_id` (string): Restrict to this organisation id. Needed when the token spans several organisations.
- `product_id` (string): Only this product's metrics.
- `start_date` (string, required): Start of the window, YYYY-MM-DD.

### `polar_list_benefits` (~111 tokens)

List benefits

List benefits — the things a product grants, such as licence keys, file downloads or Discord roles. Polar: GET /v1/benefits/.

Input parameters:

- `limit` (integer): Page size, 1-100.
- `organization_id` (string): Restrict to this organisation id. Needed when the token spans several organisations.
- `page` (integer): 1-based page number.
- `query` (string): Free-text search.
- `type` (string): Only benefits of this type.

### `polar_list_benefit_grants` (~82 tokens)

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.

Input parameters:

- `benefit_id` (string, required): The benefit's id.
- `limit` (integer): Page size, 1-100.
- `page` (integer): 1-based page number.

### `polar_list_discounts` (~91 tokens)

List discounts

List discount codes and their redemption limits. Polar: GET /v1/discounts/.

Input parameters:

- `limit` (integer): Page size, 1-100.
- `organization_id` (string): Restrict to this organisation id. Needed when the token spans several organisations.
- `page` (integer): 1-based page number.
- `query` (string): Free-text search over discount names and codes.

### `polar_list_refunds` (~120 tokens)

List refunds

List refunds, filtered by order, subscription, customer or success. Polar: GET /v1/refunds/.

Input parameters:

- `customer_id` (string): Only this customer's refunds.
- `limit` (integer): Page size, 1-100.
- `order_id` (string): Only refunds against this order.
- `organization_id` (string): Restrict to this organisation id. Needed when the token spans several organisations.
- `page` (integer): 1-based page number.
- `succeeded` (boolean): Only successful, or only failed, refunds.

### `polar_list_license_keys` (~110 tokens)

List licence keys

List issued licence keys and their status. Polar: GET /v1/license-keys/.

Input parameters:

- `benefit_id` (string): Only keys from this benefit.
- `limit` (integer): Page size, 1-100.
- `organization_id` (string): Restrict to this organisation id. Needed when the token spans several organisations.
- `page` (integer): 1-based page number.
- `status` (string): Only keys in this state, e.g. granted, revoked, disabled.

### `polar_list_meters` (~79 tokens)

List usage meters

List the usage meters that aggregate events into billable quantities. Polar: GET /v1/meters/.

Input parameters:

- `limit` (integer): Page size, 1-100.
- `organization_id` (string): Restrict to this organisation id. Needed when the token spans several organisations.
- `page` (integer): 1-based page number.

### `polar_get_meter_quantities` (~113 tokens)

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.

Input parameters:

- `customer_id` (string): Only this customer's usage.
- `end_timestamp` (string, required): ISO-8601 end of the window.
- `interval` (string, required): Bucket size for the series.
- `meter_id` (string, required): The meter's id.
- `start_timestamp` (string, required): ISO-8601 start of the window.

### `polar_list_events` (~151 tokens)

List usage events

List the raw usage events ingested for metering, filtered by customer, meter, name or time. Polar: GET /v1/events/.

Input parameters:

- `customer_id` (string): Only this customer's events.
- `end_timestamp` (string): ISO-8601 upper bound.
- `limit` (integer): Page size, 1-100.
- `meter_id` (string): Only events matching this meter.
- `name` (string): Only events with this name.
- `organization_id` (string): Restrict to this organisation id. Needed when the token spans several organisations.
- `page` (integer): 1-based page number.
- `start_timestamp` (string): ISO-8601 lower bound.

### `polar_list_webhook_deliveries` (~141 tokens)

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.

Input parameters:

- `end_timestamp` (string): ISO-8601 upper bound.
- `endpoint_id` (string): Only deliveries to this endpoint.
- `event_type` (string): Only deliveries of this event type.
- `limit` (integer): Page size, 1-100.
- `page` (integer): 1-based page number.
- `start_timestamp` (string): ISO-8601 lower bound.
- `succeeded` (boolean): Only failures, or only successes.

### `polar_list_webhook_endpoints` (~81 tokens)

List webhook endpoints

List the configured webhook endpoints and their subscribed events. Polar: GET /v1/webhooks/endpoints.

Input parameters:

- `limit` (integer): Page size, 1-100.
- `organization_id` (string): Restrict to this organisation id. Needed when the token spans several organisations.
- `page` (integer): 1-based page number.

### `polar_redeliver_webhook_event` (~54 tokens)

Redeliver a webhook event

Queue one webhook event for redelivery after your endpoint recovered. Polar: POST /v1/webhooks/events/{id}/redeliver.

Input parameters:

- `event_id` (string, required): The webhook event to resend.

### `polar_create_refund` (~122 tokens)

Refund an order

Refund an order, in full or in part. This moves real money back to the customer. Polar: POST /v1/refunds/.

Input parameters:

- `amount` (integer): Amount in the currency's minor unit (cents). Omit to refund the full order.
- `comment` (string): An internal note about the refund.
- `order_id` (string, required): The order to refund.
- `reason` (string, required): Why the refund is being issued.
- `revoke_benefits` (boolean): Also revoke the benefits the order granted. Defaults to false.

### `polar_cancel_subscription` (~84 tokens)

Cancel a subscription

Cancel a subscription at the end of its current period. The customer keeps access until then. Polar: PATCH /v1/subscriptions/{id}.

Input parameters:

- `customer_cancellation_comment` (string): The customer's own words.
- `customer_cancellation_reason` (string): Why the customer is leaving, for your churn reporting.
- `subscription_id` (string, required): The subscription to cancel.

### `polar_create_checkout_link` (~114 tokens)

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

Input parameters:

- `allow_discount_codes` (boolean): Let the buyer enter a discount code. Defaults to true.
- `discount_id` (string): Apply this discount automatically.
- `label` (string): An internal label for the link.
- `products` (array, required): Product ids the link sells.
- `success_url` (string): Where to send the buyer after payment.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-usefulapi-polar-sh/polar-sh#diagnostics

## Score history

- 2026-10-03: 78
- 2026-10-02: 78
- 2026-10-01: 77
- 2026-09-30: 72
- 2026-09-29: 18

## Common questions

### What is the io.usefulapi/polar-sh MCP server?

io.usefulapi/polar-sh is an MCP server listed in the public MCP registry as io.usefulapi/polar-sh. Products, customers, orders, subscriptions, benefits, revenue metrics and refunds. This page covers its hosted endpoint (https://polar-sh.usefulapi.io/mcp).

### Is the io.usefulapi/polar-sh MCP server safe to use?

io.usefulapi/polar-sh scores 78 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the io.usefulapi/polar-sh MCP server expose?

io.usefulapi/polar-sh exposes 26 tools: polar_list_organizations, polar_list_products, polar_get_product, polar_list_customers, polar_get_customer, and 21 more. Their descriptions and schemas cost roughly 2,525 tokens of context every time the server is loaded.

### Does the io.usefulapi/polar-sh MCP server require authentication?

Yes. io.usefulapi/polar-sh asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything.

### Is the io.usefulapi/polar-sh MCP server still maintained?

io.usefulapi/polar-sh is still listed as active in the MCP registry. We last reached this channel on 3 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://polar-sh.usefulapi.io/mcp
- Repository: https://github.com/m190/usefulapi-mcp
- Changelog RSS feed: https://verifymcp.io/servers/io-usefulapi-polar-sh/polar-sh.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-usefulapi-polar-sh/polar-sh.json
- HTML version of this page: https://verifymcp.io/servers/io-usefulapi-polar-sh/polar-sh