Polar MCP by usefulapi

io.usefulapi由 usefulapi.io 發布官方發布者v1.39.2更新於 Nov 14, 2026

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

發布方自己的服務：Ably MCP by usefulapi

已驗證Streamable HTTP可網頁執行金融資料與分析商業與電商

概覽

AI 產生的概覽

面向 Polar 帳務的託管 MCP 伺服器：讓助理讀取產品、客戶、訂單、訂閱、指標與退款，並執行少量帳務操作。

可以做什麼
  • 列出組織、產品及含價格與權益的產品詳情
  • 查詢客戶，可依 Polar id 或自有外部 id 取得客戶完整狀態
  • 列出並取得訂單、訂閱、折扣、退款與授權金鑰
  • 依日期範圍讀取營收與訂閱指標，以及用量計量器、計量數量與原始事件
  • 查看 webhook 端點與投遞紀錄，並將 webhook 事件重新投遞
  • 建立退款、取消訂閱、建立結帳連結
適用情境
適合用自然語言查詢 Polar 的營收、MRR、訂單、訂閱或客戶權益，也適合在不開啟 Polar 後台的情況下處理退款、取消訂閱和結帳連結等偶發帳務操作。
執行需求
透過 streamable HTTP 存取的遠端端點，無需本機安裝。以 OAuth 登入，登入頁要求填寫 Polar 憑證，憑證依使用者儲存。免費方案每月 50 次工具呼叫；付費方案透過 Stripe 結帳連結付款。
安裝前請注意
登入時伺服器會索取 Polar 憑證；請勿在用戶端設定中加入 API 金鑰或 Authorization 標頭。寫入類工具會動用真實資金或改變存取權限：退款會把錢退回客戶，取消訂閱會在當期結束時終止存取，webhook 重投與建立結帳連結會修改資料。呼叫次數按量計費，付費方案會產生費用，取消時當期不退款。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Polar MCP by usefulapi，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.usefulapi%2Fpolar-sh/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

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

README

Polar MCP by usefulapi

Products, customers, orders, subscriptions, benefits, revenue metrics and refunds. Hosted, no local install.

Live endpoint: https://polar-sh.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://polar-sh.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http polar-sh https://polar-sh.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "polar-sh": {      "url": "https://polar-sh.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Polar credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/polar-sh/

On first connect you'll paste your Polar credentials. They are validated, stored per-user, and scoped to you — no keys in config files.

Tools

ToolTypeWhat it does
polar_list_organizationsreadList organisations
polar_list_productsreadList products
polar_get_productreadGet one product
polar_list_customersreadList customers
polar_get_customerreadGet one customer
polar_get_customer_statereadGet a customer's full state
polar_get_customer_state_by_external_idreadGet a customer's state by your own id
polar_list_ordersreadList orders
polar_get_orderreadGet one order
polar_list_subscriptionsreadList subscriptions
polar_get_subscriptionreadGet one subscription
polar_get_metricsreadGet revenue metrics
polar_list_benefitsreadList benefits
polar_list_benefit_grantsreadList grants of a benefit
polar_list_discountsreadList discounts
polar_list_refundsreadList refunds
polar_list_license_keysreadList licence keys
polar_list_metersreadList usage meters
polar_get_meter_quantitiesreadGet a meter's quantities
polar_list_eventsreadList usage events
polar_list_webhook_deliveriesreadList webhook deliveries
polar_list_webhook_endpointsreadList webhook endpoints
polar_redeliver_webhook_eventwriteRedeliver a webhook event
polar_create_refundwriteRefund an order
polar_cancel_subscriptionwriteCancel a subscription
polar_create_checkout_linkwriteCreate a checkout link
polar_sh_usage_statusmetaUsage status (free-tier meter)
polar_sh_request_featuremetaRequest a missing feature
polar_sh_upgrademetaUpgrade to Pro or Pro+
polar_sh_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro$9/mo or $90/yr (2 months free)10,000 tool calls / month
Pro+$39/mo or $390/yr (2 months free)100,000 tool calls / month

Each paid plan covers this server only. Ask your AI to run polar_sh_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with polar_sh_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with polar_sh_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT

來源：servers/polar-sh/README.md，提交 f22f848

工具

26

polar_list_organizations

List organisations

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

輸入參數pagelimit

polar_list_products

List products

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

輸入參數pagelimitqueryis_archivedis_recurringorganization_id

polar_get_product

Get one product

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

輸入參數product_id必填

polar_list_customers

List customers

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

輸入參數pageemaillimitqueryorganization_id

polar_get_customer

Get one customer

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

輸入參數customer_id必填

polar_get_customer_state

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.

輸入參數customer_id必填

polar_get_customer_state_by_external_id

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.

輸入參數external_id必填

polar_list_orders

List orders

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

輸入參數pagelimitstatusproduct_idcustomer_idcreated_aftercreated_beforeorganization_idsubscription_id

polar_get_order

Get one order

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

輸入參數order_id必填

polar_list_subscriptions

List subscriptions

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

輸入參數pagelimitactivestatusproduct_idcustomer_idorganization_idcancel_at_period_end

polar_get_subscription

Get one subscription

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

輸入參數subscription_id必填

polar_get_metrics

Get revenue metrics

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

輸入參數end_date必填interval必填product_idstart_date必填customer_idorganization_id

polar_list_benefits

List benefits

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

輸入參數pagetypelimitqueryorganization_id

polar_list_benefit_grants

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.

輸入參數pagelimitbenefit_id必填

polar_list_discounts

List discounts

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

輸入參數pagelimitqueryorganization_id

polar_list_refunds

List refunds

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

輸入參數pagelimitorder_idsucceededcustomer_idorganization_id

polar_list_license_keys

List licence keys

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

輸入參數pagelimitstatusbenefit_idorganization_id

polar_list_meters

List usage meters

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

輸入參數pagelimitorganization_id

polar_get_meter_quantities

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.

輸入參數interval必填meter_id必填customer_idend_timestamp必填start_timestamp必填

polar_list_events

List usage events

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

輸入參數namepagelimitmeter_idcustomer_idend_timestamporganization_idstart_timestamp

polar_list_webhook_deliveries

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.

輸入參數pagelimitsucceededevent_typeendpoint_idend_timestampstart_timestamp

polar_list_webhook_endpoints

List webhook endpoints

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

輸入參數pagelimitorganization_id

polar_redeliver_webhook_event

Redeliver a webhook event

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

輸入參數event_id必填

polar_create_refund

Refund an order

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

輸入參數amountreason必填commentorder_id必填revoke_benefits

polar_cancel_subscription

Cancel a subscription

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

輸入參數subscription_id必填customer_cancellation_reasoncustomer_cancellation_comment

版本歷史

26
  1. v1.39.2最新Nov 14, 2026
  2. v1.39.1Nov 13, 2026
  3. v1.38.0Nov 12, 2026
  4. v1.37.3Nov 11, 2026
  5. v1.36.5Nov 8, 2026
  6. v1.36.4Nov 7, 2026
  7. v1.35.3Nov 5, 2026
  8. v1.35.2Nov 5, 2026
  9. v1.35.1Nov 4, 2026
  10. v1.35.0Nov 3, 2026
  11. v1.34.1Nov 3, 2026
  12. v1.33.0Nov 1, 2026
  13. v1.31.0Oct 31, 2026
  14. v1.30.0Oct 31, 2026
  15. v1.29.2Oct 30, 2026
  16. v1.29.0Oct 30, 2026
  17. v1.24.0Oct 26, 2026
  18. v1.21.3Oct 25, 2026
  19. v1.21.0Oct 25, 2026
  20. v1.20.0Oct 24, 2026
  21. v1.17.0Oct 23, 2026
  22. v1.16.4Oct 22, 2026
  23. v1.16.3Oct 21, 2026
  24. v1.11.1Oct 9, 2026
  25. v1.10.0Oct 9, 2026
  26. v1.0.0Sep 29, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Usefulapi 整合

Ably MCP by usefulapi

io.usefulapi官方發布者

針對 Ably 的託管 MCP 伺服器，讓助理檢視頻道、線上狀態與用量統計、發布訊息，並查看應用程式設定。

Streamable HTTP可網頁執行
溝通與協作15 個工具Nov 14, 2026

ROLLER MCP by usefulapi

io.usefulapi官方發布者

唯讀存取 ROLLER 場館資料：搜尋預訂、查詢產品可用性，並查看賓客、免責聲明、禮品卡與每日報表。

Streamable HTTP可網頁執行
資料與分析42 個工具Nov 14, 2026

Planerio MCP by usefulapi

io.usefulapi官方發布者

託管的 Planerio 連接器，讓助理讀取排班、人力需求、可用人員、員工資料、缺勤與年假天數。

Streamable HTTP可網頁執行
效率與工作流6 個工具Nov 14, 2026

Marmin MCP by usefulapi

io.usefulapi官方發布者

唯讀存取 Marmin 的阿聯酋電子發票資料：發票、貸項通知單、UBL XML、Peppol 狀態與業務檔案。

Streamable HTTP可網頁執行
金融10 個工具Nov 14, 2026

Oyster MCP by usefulapi

io.usefulapi官方發布者

面向 Oyster 的遠端 MCP 伺服器，讓助理讀取團隊、休假、費用、合約與發票資料，並核准或拒絕相關申請。

Streamable HTTP可網頁執行
效率與工作流20 個工具Nov 14, 2026