refund-decide

@ndkasndakn/refund-decide

Hosted

0 Stars 4 次浏览 ndkasndakn 更新于 2026-08-23

Refund eligibility notary for US subscriptions. Returns ALLOWED/DENIED/UNKNOWN.

金融

该服务暂未提供标准配置，请参考 README 手动接入

可用工具（5 个）

该服务在 MCP 协议中暴露的工具，AI 可按需调用

tavily_search 14 个参数需填 1 项 Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.

Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.

必填参数：query

tavily_extract 6 个参数需填 1 项 Extract content from URLs. Returns raw page content in markdown or text format.

Extract content from URLs. Returns raw page content in markdown or text format.

必填参数：urls

tavily_crawl 11 个参数需填 1 项 Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.

Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.

必填参数：url

tavily_map 8 个参数需填 1 项 Map a website's structure. Returns a list of URLs found starting from the base URL.

Map a website's structure. Returns a list of URLs found starting from the base URL.

必填参数：url

tavily_research 2 个参数需填 1 项 Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings.

Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings.

必填参数：input

服务介绍

decide.fyi

Deterministic subscription decision notaries for US consumers

# One-Click Install

Add to Cursor [ Add to Claude ](# connect-via-mcp-claude-desktop- -windsurf- -other-clients) [ Add to ChatGPT ](# connect-via-mcp-claude-desktop- -windsurf- -other-clients) [ Add to Codex ](# connect-via-mcp-claude-desktop- -windsurf- -other-clients) [ Add to Gemini ](# connect-via-mcp-claude-desktop- -windsurf- -other-clients)

Buttons install the Refund Notary server. To add all 4 servers, use the [JSON config below](# connect-via-mcp-claude-desktop- -windsurf- -other-clients).

# MCP Servers

All servers: 100 vendors, US region, individual plans, stateless, no auth, 100 req/min.

# Quick Start

# # Connect via MCP (Claude Desktop / Windsurf / other clients)

{
  "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

#  Refund eligibility
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"}'

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

#  Return eligibility
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"}'

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

# # Local Dev Checks

Start local dev server:

npx vercel dev

In a separate terminal:

#  Handler-level smoke checks (no running server required)
npm run smoke

#  MCP endpoint checks (requires vercel dev running on localhost:3000)
npm run mcp:check

#  End-to-end workflow fixture (example -> result)
npm run workflow:test

# Zendesk Workflow Orchestrators

Use workflow endpoints when you want one request to return:

decision classification (yes | no | tie) from /api/decide
policy result from the relevant notary endpoint
recommended Zendesk action + tags + private note with request_id

Endpoints

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

# # Request

{
  "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
}

For refund and return, include days_since_purchase.

# # Deterministic test mode

Set decision_override to bypass model classification during fixtures and CI:

{
  "decision_override": "yes"
}

# # Response (example)

{
  "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"]
  }
}

# Refund Notary

Endpoint: POST https://refund.decide.fyi/api/v1/refund/eligibility
MCP Tool: refund_eligibility

Checks if a subscription purchase is within the vendor's refund window.

Input: vendor, days_since_purchase, region, plan

{"refundable":true,"verdict":"ALLOWED","code":"WITHIN_WINDOW","message":"Refund is allowed. Purchase is 12 day(s) old, within 14 day window.","vendor":"adobe","window_days":14}

Codes: WITHIN_WINDOW, OUTSIDE_WINDOW, NO_REFUNDS, UNSUPPORTED_VENDOR

# Cancel Notary

Endpoint: POST https://cancel.decide.fyi/api/v1/cancel/penalty
MCP Tool: cancellation_penalty

Checks cancellation penalties — early termination fees, contract locks, or free cancellation.

Input: vendor, region, plan

{"verdict":"PENALTY","code":"EARLY_TERMINATION_FEE","message":"adobe charges an early termination fee: 50% of remaining months on annual plan.","vendor":"adobe","policy":"etf"}

Codes: NO_PENALTY, EARLY_TERMINATION_FEE, CONTRACT_LOCKED, UNSUPPORTED_VENDOR

# Return Notary

Endpoint: POST https://return.decide.fyi/api/v1/return/eligibility
MCP Tool: return_eligibility

Checks if a subscription purchase can be returned/reversed, with return type and method.

Input: vendor, days_since_purchase, region, plan

{"returnable":true,"verdict":"RETURNABLE","code":"FULL_RETURN","message":"Return is available. Purchase is 5 day(s) old, within 14-day window.","vendor":"adobe","return_type":"full_refund","method":"self_service"}

Codes: FULL_RETURN, PRORATED_RETURN, CREDIT_RETURN, OUTSIDE_WINDOW, NO_RETURNS, UNSUPPORTED_VENDOR

# Trial Notary

Endpoint: POST https://trial.decide.fyi/api/v1/trial/terms
MCP Tool: trial_terms

Checks free trial availability, length, card requirement, and auto-conversion status.

Input: vendor, region, plan

{"verdict":"TRIAL_AVAILABLE","code":"AUTO_CONVERTS","message":"adobe offers a 7-day free trial. Credit card required. Auto-converts to paid plan.","vendor":"adobe","trial_days":7,"card_required":true,"auto_converts":true}

Codes: AUTO_CONVERTS, NO_AUTO_CONVERT, TRIAL_NOT_AVAILABLE, UNSUPPORTED_VENDOR

# Supported Vendors (100)

Scope: US region, individual plans only.

# Data Freshness

Policies are sourced from official vendor documentation and terms of service.

Daily automated checks — GitHub Action runs at 08:00 UTC, hashing vendor policy pages across all 4 services (refund, cancel, return, trial). If a page changes, an issue is opened for review.
Policy source URLs tracked — Each service has its own sources file in rules/ linking to official policy pages.
Compliance export — GET /api/compliance-export returns a CSV snapshot of tracked sources, hashes, and pending candidate changes (?format=json for machine-readable output).
Versioned rules — Each rules file includes a rules_version field for staleness detection.

# Architecture

Stateless — No database, no sessions, no side effects
Deterministic — Same input always produces same output
Versioned Rules — Rules files include version for tracking changes
Daily Monitoring — GitHub Action checks all vendor policy pages daily
Serverless — Runs on Vercel serverless functions
Zero Dependencies — Core compute logic has no external dependencies
Hostname Routing — Vercel middleware routes subdomains to correct MCP endpoints

# Limitations

US Only — Currently only supports US region
Individual Plans Only — Business/enterprise plans not yet supported
Calendar Days — Windows are based on calendar days, not business days
Static Rules — Does not account for promotional offers or special circumstances

# Changelog

# # Unreleased

Added:

GET /api/compliance-export endpoint for policy monitoring evidence export (CSV default, JSON via ?format=json).
Smoke test coverage for compliance export JSON and CSV paths.

# # v1.2.1 (2026-02-08)

Changed:

Subdomain homepage now shows the relevant notary card (refund/cancel/return/trial).
Version metadata is consistent across server.json, MCP initialize, and /.well-known/ *.

# # v1.2.0 (2026-02-02)

Added:

Cancel Notary MCP (cancel.decide.fyi) — cancellation penalty checker
Return Notary MCP (return.decide.fyi) — return eligibility checker
Trial Notary MCP (trial.decide.fyi) — free trial terms checker
Hostname-based middleware routing for all subdomains
Policy source files and daily checking for cancel, return, and trial policies
Humans/Agents mode toggle on landing page
MCP catalog with cards for all 4 servers

Fixed:

Daily policy checker: added contents:write permission and fixed shell logic
Removed dead Cloudflare email-decode scripts causing 404s

# # v1.1.0 (2026-02-01)

Added:

Expanded from 64 to 100 supported vendors
Daily policy-check GitHub Action (cron at 08:00 UTC)
Policy source URLs tracked in rules/policy-sources.json
MCP vendor enum in inputSchema for agent discoverability

Fixed:

ERR_IMPORT_ATTRIBUTE_MISSING crash on Vercel (Node 22 import attributes)

# # v1.0.0 (2026-01-15)

Added:

Initial release with REST API and MCP server
Support for 9 vendors

# Free API (No Auth)

All 4 servers are free to use. No authentication. No API keys.

Rate limit: 100 requests/minute per IP.

Questions? decidefyi@gmail.com or @decidefyi on X

# Links

Website: https://decide.fyi
Refund: https://refund.decide.fyi
Cancel: https://cancel.decide.fyi
Return: https://return.decide.fyi
Trial: https://trial.decide.fyi
X/Twitter: @decidefyi
MCP Spec: https://modelcontextprotocol.io

Built with love by the decide.fyi team

查看源码项目主页

可用工具 （5 个）

服务介绍

decide.fyi

# One-Click Install

# MCP Servers

# Quick Start

# # Connect via MCP (Claude Desktop / Windsurf / other clients)

# # REST API

# # Local Dev Checks

# Zendesk Workflow Orchestrators

# # Request

# # Deterministic test mode

# # Response (example)

# Refund Notary

# Cancel Notary

# Return Notary

# Trial Notary

# Supported Vendors (100)

# Data Freshness

# Architecture

# Limitations

# Changelog

# # Unreleased

# # v1.2.1 (2026-02-08)

# # v1.2.0 (2026-02-02)

# # v1.1.0 (2026-02-01)

# # v1.0.0 (2026-01-15)

# Free API (No Auth)

# Links

相关 MCP 服务

开源版 与 企业版

企业版（含 FDE 交付）

技能定制开发服务

可用工具（5 个）

开源版与企业版