金大哥 - decide MCP 详情

article

README

🚀 decide.fyi

Decide.fyi 为美国消费者提供确定性的订阅决策公证服务，帮助用户快速、准确地了解订阅服务的退款、取消、退货和试用等相关政策。

🚀 快速开始

一键安装

Add to Cursor Add to Claude Add to ChatGPT Add to Codex Add to Gemini

点击按钮将安装 Refund Notary 服务器。若要添加全部 4 个服务器，请使用下方的 JSON 配置。

通过 MCP 连接（Claude 桌面版 / Windsurf / 其他客户端）

{
  "mcpServers": {
    "refund-decide": { "url": "https://refund.decide.fyi/api/mcp" },
    "cancel-decide": { "url": "https://cancel.decide.fyi/api/mcp" },
    "return-decide": { "url": "https://return.decide.fyi/api/mcp" },
    "trial-decide":  { "url": "https://trial.decide.fyi/api/mcp" }
  }
}

REST API

# 退款资格检查
curl -X POST https://refund.decide.fyi/api/v1/refund/eligibility \
  -H "Content-Type: application/json" \
  -d '{"vendor":"adobe","days_since_purchase":12,"region":"US","plan":"individual"}'

# 取消订阅惩罚检查
curl -X POST https://cancel.decide.fyi/api/v1/cancel/penalty \
  -H "Content-Type: application/json" \
  -d '{"vendor":"adobe","region":"US","plan":"individual"}'

# 退货资格检查
curl -X POST https://return.decide.fyi/api/v1/return/eligibility \
  -H "Content-Type: application/json" \
  -d '{"vendor":"adobe","days_since_purchase":12,"region":"US","plan":"individual"}'

# 试用条款检查
curl -X POST https://trial.decide.fyi/api/v1/trial/terms \
  -H "Content-Type: application/json" \
  -d '{"vendor":"adobe","region":"US","plan":"individual"}'

本地开发检查

启动本地开发服务器：

npx vercel dev

在另一个终端中：

# 处理程序级冒烟测试（无需运行服务器）
npm run smoke

# MCP 端点检查（需要在本地主机:3000 上运行 vercel dev）
npm run mcp:check

# 端到端工作流测试（示例 -> 结果）
npm run workflow:test

✨ 主要特性

多服务支持：提供退款、取消订阅、退货和试用条款的检查服务。
多客户端兼容：支持多种客户端，如 Cursor、VS Code、Claude、ChatGPT 等。
数据实时性：每日自动检查供应商政策页面，确保数据新鲜度。
架构优势：无状态、确定性、版本化规则、每日监控、无服务器、零依赖。

📦 安装指南

一键安装

可通过以下按钮一键安装 Refund Notary 服务器： Add to Cursor Add to Claude Add to ChatGPT Add to Codex Add to Gemini

若要添加全部 4 个服务器，请使用下方的 JSON 配置。

通过 MCP 连接

使用以下 JSON 配置连接到所有服务：

{
  "mcpServers": {
    "refund-decide": { "url": "https://refund.decide.fyi/api/mcp" },
    "cancel-decide": { "url": "https://cancel.decide.fyi/api/mcp" },
    "return-decide": { "url": "https://return.decide.fyi/api/mcp" },
    "trial-decide":  { "url": "https://trial.decide.fyi/api/mcp" }
  }
}

💻 使用示例

基础用法 - REST API

退款资格检查

curl -X POST https://refund.decide.fyi/api/v1/refund/eligibility \
  -H "Content-Type: application/json" \
  -d '{"vendor":"adobe","days_since_purchase":12,"region":"US","plan":"individual"}'

取消订阅惩罚检查

curl -X POST https://cancel.decide.fyi/api/v1/cancel/penalty \
  -H "Content-Type: application/json" \
  -d '{"vendor":"adobe","region":"US","plan":"individual"}'

退货资格检查

curl -X POST https://return.decide.fyi/api/v1/return/eligibility \
  -H "Content-Type: application/json" \
  -d '{"vendor":"adobe","days_since_purchase":12,"region":"US","plan":"individual"}'

试用条款检查

curl -X POST https://trial.decide.fyi/api/v1/trial/terms \
  -H "Content-Type: application/json" \
  -d '{"vendor":"adobe","region":"US","plan":"individual"}'

高级用法 - Zendesk 工作流编排

当你希望一个请求返回以下内容时，可以使用工作流端点：

来自 /api/decide 的决策分类 (yes | no | tie)
相关公证端点的政策结果
推荐的 Zendesk 操作 + 标签 + 包含 request_id 的私有备注

端点

POST https://refund.decide.fyi/api/v1/workflows/zendesk/refund
POST https://cancel.decide.fyi/api/v1/workflows/zendesk/cancel
POST https://return.decide.fyi/api/v1/workflows/zendesk/return
POST https://trial.decide.fyi/api/v1/workflows/zendesk/trial

请求示例

{
  "ticket_id": "ZD-9001",
  "workflow_type": "refund",
  "question": "Should this Adobe annual plan refund request proceed under policy?",
  "vendor": "adobe",
  "region": "US",
  "plan": "individual",
  "days_since_purchase": 5
}

对于 refund 和 return 请求，请包含 days_since_purchase。

确定性测试模式

在测试和持续集成期间，可以设置 decision_override 来绕过模型分类：

{
  "decision_override": "yes"
}

响应示例

{
  "ok": true,
  "flow": "zendesk_refund_v1",
  "ticket_id": "ZD-9001",
  "decision": { "c": "yes", "request_id": "req_123" },
  "policy": { "verdict": "ALLOWED", "code": "WITHIN_WINDOW" },
  "action": {
    "type": "approve_refund",
    "zendesk_tags": ["decide", "decide_yes", "refund_allowed"]
  }
}

📚 详细文档

MCP 服务器信息

| 服务器 | 域名 | 工具 | 裁决结果 | |--------|--------|------|----------| | Refund Notary | refund.decide.fyi | refund_eligibility | ALLOWED / DENIED / UNKNOWN | | Cancel Notary | cancel.decide.fyi | cancellation_penalty | FREE_CANCEL / PENALTY / LOCKED / UNKNOWN | | Return Notary | return.decide.fyi | return_eligibility | RETURNABLE / EXPIRED / NON_RETURNABLE / UNKNOWN | | Trial Notary | trial.decide.fyi | trial_terms | TRIAL_AVAILABLE / NO_TRIAL / UNKNOWN |

所有服务器支持 100 个供应商，服务区域为美国，仅支持个人计划，无状态，无需认证，每分钟 100 个请求。

支持的供应商

| 供应商 | 标识符 | 退款 | 取消 | 退货 | 试用 | |--------|-----------|--------|--------|--------|-------| | 1Password | 1password | 无退款 | 免费 | 无退货 | 14 天 | | Adobe | adobe | 14 天 | ETF | 14 天全额退款 | 7 天 | | Amazon Prime | amazon_prime | 3 天 | 免费 | 3 天全额退款 | 30 天 | | Apple App Store | apple_app_store | 14 天 | 免费 | 14 天全额退款 | - | | Apple Music | apple_music | 无退款 | 免费 | 无退货 | 30 天 | | Apple TV+ | apple_tv_plus | 无退款 | 免费 | 无退货 | 7 天 | | Audible | audible | 无退款 | 免费 | 无退货 | 30 天 | | Bitwarden | bitwarden | 30 天 | 免费 | 30 天全额退款 | 7 天 | | Bumble | bumble | 无退款 | 免费 | 无退货 | 7 天 | | Calm | calm | 30 天 | 免费 | 30 天全额退款 | 7 天 | | Canva | canva | 无退款 | 免费 | 无退货 | 30 天 | | ChatGPT Plus | chatgpt_plus | 无退款 | 免费 | 无退货 | - | | Claude Pro | claude_pro | 无退款 | 免费 | 无退货 | - | | Coursera Plus | coursera_plus | 14 天 | 免费 | 14 天全额退款 | 7 天 | | Crunchyroll | crunchyroll | 无退款 | 免费 | 无退货 | 7 天 | | Deezer | deezer | 无退款 | 免费 | 无退货 | 30 天 | | Disney+ | disney_plus | 无退款 | 免费 | 无退货 | - | | DoorDash DashPass | doordash_dashpass | 无退款 | 免费 | 无退货 | 30 天 | | Dropbox (US) | dropbox_us | 无退款 | 免费 | 无退货 | 30 天 | | Duolingo | duolingo | 无退款 | 免费 | 无退货 | 14 天 | | Evernote | evernote | 20 天 | 免费 | 20 天全额退款 | 14 天 | | ExpressVPN | expressvpn | 30 天 | 免费 | 30 天全额退款 | 7 天 | | Figma | figma | 无退款 | 免费 | 无退货 | 30 天 | | Fubo TV | fubo_tv | 无退款 | 免费 | 无退货 | 7 天 | | GitHub Pro | github_pro | 无退款 | 免费 | 无退货 | - | | Google Play | google_play | 2 天 | 免费 | 2 天全额退款 | - | | Grammarly | grammarly | 无退款 | 免费 | 无退货 | 7 天 | | Headspace | headspace | 无退款 | 免费 | 无退货 | 7 天 | | HelloFresh | hellofresh | 无退款 | 免费（提前 5 天通知） | 无退货 | - | | Hinge | hinge | 无退款 | 免费 | 无退货 | 7 天 | | Hulu | hulu | 无退款 | 免费 | 无退货 | 30 天 | | iCloud+ | icloud_plus | 14 天 | 免费 | 14 天全额退款 | - | | Instacart+ | instacart_plus | 5 天 | 免费 | 5 天全额退款 | 14 天 | | LinkedIn Premium | linkedin_premium | 7 天 | 免费 | 7 天全额退款 | 30 天 | | MasterClass | masterclass | 30 天 | 免费 | 30 天全额退款 | - | | Max (HBO) | max | 无退款 | 免费 | 无退货 | - | | Microsoft 365 | microsoft_365 | 30 天 | 免费 | 30 天全额退款 | 30 天 | | Midjourney | midjourney | 无退款 | 免费 | 无退货 | - | | Netflix | netflix | 无退款 | 免费 | 无退货 | - | | Nintendo Switch Online | nintendo_switch_online | 无退款 | 免费 | 无退货 | 7 天 | | Noom | noom | 14 天 | 免费 | 14 天全额退款 | 7 天 | | NordVPN | nordvpn | 30 天 | 免费 | 30 天全额退款 | 7 天 | | Notion | notion | 3 天 | 免费 | 3 天全额退款 | - | | Paramount+ | paramount_plus | 无退款 | 免费 | 无退货 | 7 天 | | Peacock | peacock | 无退款 | 免费 | 无退货 | 7 天 | | Peloton | peloton | 无退款 | 免费 | 无退货 | 30 天 | | PlayStation Plus | playstation_plus | 14 天 | 免费 | 14 天按比例退款 | 14 天 | | Scribd | scribd | 30 天 | 免费 | 30 天全额退款 | 30 天 | | Shutterstock | shutterstock | 无退款 | ETF | 无退货 | 30 天 | | Slack | slack | 无退款 | 免费 | 信用退款 | 90 天 | | Sling TV | sling_tv | 无退款 | 免费 | 无退货 | - | | Spotify | spotify | 无退款 | 免费 | 无退货 | 30 天 | | Squarespace | squarespace | 14 天 | 免费 | 14 天全额退款 | 14 天 | | Strava | strava | 14 天 | 免费 | 14 天全额退款 | 30 天 | | Surfshark | surfshark | 30 天 | 免费 | 30 天全额退款 | 7 天 | | Tidal | tidal | 无退款 | 免费 | 无退货 | 30 天 | | Tinder | tinder | 无退款 | 免费 | 无退货 | - | | Todoist | todoist | 30 天 | 免费 | 30 天全额退款 | 30 天 | | Twitch | twitch | 无退款 | 免费 | 无退货 | - | | Walmart+ | walmart_plus | 无退款 | 免费 | 无退货 | 30 天 | | Wix | wix | 14 天 | 免费 | 14 天全额退款 | 14 天 | | Xbox Game Pass | xbox_game_pass | 30 天 | 免费 | 30 天全额退款 | 14 天 | | YouTube Premium | youtube_premium | 无退款 | 免费 | 无退货 | 30 天 | | Zoom | zoom | 无退款 | 免费 | 无退货 | - |

服务范围：仅支持美国地区的个人计划。

数据新鲜度

政策信息来源于供应商的官方文档和服务条款。

每日自动检查：GitHub Action 会在协调世界时 08:00 运行，对所有 4 项服务（退款、取消、退货、试用）的供应商政策页面进行哈希处理。如果页面发生变化，将开启一个问题进行审核。
政策源 URL 跟踪：每个服务在 rules/ 目录下都有自己的源文件，链接到官方政策页面。
合规性导出：GET /api/compliance-export 返回跟踪源、哈希值和待处理候选更改的 CSV 快照（?format=json 可获取机器可读输出）。
规则版本化：每个规则文件都包含一个 rules_version 字段，用于检测数据陈旧性。

免费 API（默认：无需认证）

所有 4 个政策服务器均可免费使用，无需认证，也无需 API 密钥。 /api/decide 默认公开，可通过在服务器环境变量中设置 DECIDE_API_KEY 进行保护。如果你在 decidesite 代理后面运行 decide 并使用动态客户密钥，还需设置：

DECIDE_PROXY_SHARED_TOKEN：在 x-decide-proxy-token 头中需要的共享密钥，用于可信代理调用。
DECIDE_API_KEY：可信代理转发到上游的后端内部密钥（建议保持后端私有）。

速率限制：每个 IP 每分钟 100 个请求。

政策获取钩子（用于政策检查器浏览器钩子通道）

当直接获取被阻止时，可以使用 POST /api/policy-fetch-hook 作为每日检查器的获取适配器。

请求体：

{
  "url": "https://example.com/policy",
  "vendor": "example_vendor",
  "policy_type": "refund",
  "timeout_ms": 18000
}

认证：

Authorization: Bearer <POLICY_CHECK_BROWSER_HOOK_TOKEN> 或 x-hook-token: <token>

服务器环境变量：

POLICY_CHECK_BROWSER_HOOK_TOKEN（端点认证必需）
POLICY_FETCH_BROWSERLESS_TOKEN（可选；启用无头浏览器渲染优先）
POLICY_FETCH_BROWSERLESS_CONTENT_URL（可选覆盖；默认 https://chrome.browserless.io/content）
POLICY_FETCH_ALLOWED_HOSTS（可选，逗号分隔的主机白名单）

检查器（GitHub Actions，仓库 decide）：

密钥 POLICY_CHECK_BROWSER_HOOK_URL = 部署的端点 URL（例如：https://decide-1.vercel.app/api/policy-fetch-hook）
密钥 POLICY_CHECK_BROWSER_HOOK_TOKEN = 与运行时环境相同的令牌
变量 POLICY_CHECK_FETCH_LANES_DEFAULT = browser_hook,direct,zendesk_api,mirror

如有疑问，请联系 decidefyi@gmail.com 或在 X 平台上联系 @decidefyi。

链接

网站：https://decide.fyi
退款服务：https://refund.decide.fyi
取消订阅服务：https://cancel.decide.fyi
退货服务：https://return.decide.fyi
试用服务：https://trial.decide.fyi
X/Twitter：@decidefyi
MCP 规范：https://modelcontextprotocol.io

🔧 技术细节

架构特点

无状态：无需数据库、会话，无副作用。
确定性：相同输入始终产生相同输出。
规则版本化：规则文件包含版本信息，便于跟踪更改。
每日监控：GitHub Action 每日检查所有供应商政策页面。
无服务器：运行在 Vercel 无服务器函数上。
零依赖：核心计算逻辑无外部依赖。
主机名路由：Vercel 中间件将子域名路由到正确的 MCP 端点。

局限性

仅支持美国地区：目前仅支持美国区域。
仅支持个人计划：暂不支持企业/商业计划。
按自然日计算：时间窗口基于自然日，而非工作日。
静态规则：未考虑促销优惠或特殊情况。

📄 许可证

文档未提及相关许可证信息。

📝 更新日志

未发布

新增：GET /api/compliance-export 端点，用于导出政策监控证据（默认 CSV 格式，可通过 ?format=json 获取 JSON 格式）。
新增：合规性导出 JSON 和 CSV 路径的冒烟测试覆盖。

v1.2.1 (2026-02-08)

更改：子域名主页现在显示相关的公证卡片（退款/取消/退货/试用）。
更改：server.json、MCP initialize 和 /.well-known/* 中的版本元数据保持一致。

v1.2.0 (2026-02-02)

新增：Cancel Notary MCP（cancel.decide.fyi）—— 取消订阅惩罚检查器。
新增：Return Notary MCP（return.decide.fyi）—— 退货资格检查器。
新增：Trial Notary MCP（trial.decide.fyi）—— 免费试用条款检查器。
新增：基于主机名的中间件路由，适用于所有子域名。
新增：取消、退货和试用政策的政策源文件和每日检查。
新增：着陆页上的人类/代理模式切换。
新增：包含所有 4 个服务器卡片的 MCP 目录。
修复：每日政策检查器：添加 contents:write 权限并修复 shell 逻辑。
修复：移除导致 404 错误的无效 Cloudflare 电子邮件解码脚本。

v1.1.0 (2026-02-01)

新增：支持的供应商数量从 64 个扩展到 100 个。
新增：每日政策检查 GitHub Action（协调世界时 08:00 定时执行）。
新增：rules/policy-sources.json 中跟踪政策源 URL。
新增：MCP 供应商 enum 输入模式，便于代理发现。
修复：Vercel 上的 ERR_IMPORT_ATTRIBUTE_MISSING 崩溃问题（Node 22 导入属性）。

v1.0.0 (2026-01-15)

新增：初始版本，包含 REST API 和 MCP 服务器。
新增：支持 9 个供应商。

由 decide.fyi 团队用心打造。

decide

README

🚀 decide.fyi

🚀 快速开始

一键安装

通过 MCP 连接（Claude 桌面版 / Windsurf / 其他客户端）

REST API

本地开发检查

✨ 主要特性

📦 安装指南

一键安装

通过 MCP 连接

💻 使用示例

基础用法 - REST API

退款资格检查

取消订阅惩罚检查

退货资格检查

试用条款检查

高级用法 - Zendesk 工作流编排

端点

请求示例

确定性测试模式

响应示例

📚 详细文档

MCP 服务器信息

支持的供应商

数据新鲜度

免费 API（默认：无需认证）

政策获取钩子（用于政策检查器浏览器钩子通道）

链接

🔧 技术细节

架构特点

局限性

📄 许可证

📝 更新日志

未发布

v1.2.1 (2026-02-08)

v1.2.0 (2026-02-02)

v1.1.0 (2026-02-01)

v1.0.0 (2026-01-15)

运行方式说明

托管运行

本地运行 / 其它方式