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