Decide

🚀 decide.fyi

米国の消費者向けの決定論的なサブスクリプション決定公証人

🚀 クイックスタート

ワンクリックインストール

これらのボタンをクリックすると、Refund Notary サーバーがインストールされます。4つのサーバーをすべて追加するには、以下のJSON設定 を使用してください。

MCPサーバー

すべてのサーバー: 100のベンダー、米国地域、個人プラン、ステートレス、認証不要、100リクエスト/分

MCP経由で接続する（Claude Desktop / 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エンドポイントのチェック（localhost:3000でvercel devを実行する必要があります）
npm run mcp:check

# エンドツーエンドのワークフローのテスト（例 -> 結果）
npm run workflow:test

✨ 主な機能

Zendeskワークフローオーケストレーター

1つのリクエストで以下の情報を返したい場合には、ワークフローエンドポイントを使用します:

• /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": "このAdobeの年間プランの返金申請はポリシーに基づいて承認されるべきですか？",
  "vendor": "adobe",
  "region": "US",
  "plan": "individual",
  "days_since_purchase": 5
}

refund と return の場合は、days_since_purchase を含めてください。

決定論的なテストモード

fixtureやCIの際にモデル分類をバイパスするには、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"]
  }
}

Refund Notary

エンドポイント: POST https://refund.decide.fyi/api/v1/refund/eligibility MCPツール: refund_eligibility

サブスクリプションの購入がベンダーの返金期間内かどうかを確認します。

入力: vendor, days_since_purchase, region, plan

{"refundable":true,"verdict":"ALLOWED","code":"WITHIN_WINDOW","message":"返金が許可されます。購入から12日経過しており、14日の返金期間内です。","vendor":"adobe","window_days":14}

コード: WITHIN_WINDOW, OUTSIDE_WINDOW, NO_REFUNDS, UNSUPPORTED_VENDOR

Cancel Notary

エンドポイント: POST https://cancel.decide.fyi/api/v1/cancel/penalty MCPツール: cancellation_penalty

キャンセルのペナルティ（早期解約料、契約ロック、または無料キャンセル）を確認します。

入力: vendor, region, plan

{"verdict":"PENALTY","code":"EARLY_TERMINATION_FEE","message":"adobeは早期解約料を請求します: 年間プランの残り月数の50%。","vendor":"adobe","policy":"etf"}

コード: NO_PENALTY, EARLY_TERMINATION_FEE, CONTRACT_LOCKED, UNSUPPORTED_VENDOR

Return Notary

エンドポイント: POST https://return.decide.fyi/api/v1/return/eligibility MCPツール: return_eligibility

サブスクリプションの購入が返品/取り消し可能かどうか、返品の種類と方法を確認します。

入力: vendor, days_since_purchase, region, plan

{"returnable":true,"verdict":"RETURNABLE","code":"FULL_RETURN","message":"返品が可能です。購入から5日経過しており、14日の返品期間内です。","vendor":"adobe","return_type":"full_refund","method":"self_service"}

コード: FULL_RETURN, PRORATED_RETURN, CREDIT_RETURN, OUTSIDE_WINDOW, NO_RETURNS, UNSUPPORTED_VENDOR

Trial Notary

エンドポイント: POST https://trial.decide.fyi/api/v1/trial/terms MCPツール: trial_terms

無料トライアルの可用性、期間、カードの必要性、自動契約更新の状態を確認します。

入力: vendor, region, plan

{"verdict":"TRIAL_AVAILABLE","code":"AUTO_CONVERTS","message":"adobeは7日間の無料トライアルを提供しています。クレジットカードが必要です。有料プランに自動契約更新されます。","vendor":"adobe","trial_days":7,"card_required":true,"auto_converts":true}

コード: AUTO_CONVERTS, NO_AUTO_CONVERT, TRIAL_NOT_AVAILABLE, UNSUPPORTED_VENDOR

📦 インストール

ワンクリックインストールのボタンを使用することで、Refund Notary サーバーを簡単にインストールできます。また、4つのサーバーをすべて追加するには、MCP経由で接続する際のJSON設定を使用してください。

📚 ドキュメント

サポートされるベンダー (100)

対象範囲: 米国地域、個人プランのみ

データの鮮度

ポリシーは、公式のベンダードキュメントとサービス利用規約から取得されています。

• 毎日の自動チェック — GitHub ActionがUTC 08:00に実行され、4つのサービス（返金、キャンセル、返品、トライアル）すべてのベンダーポリシーページのハッシュを計算します。ページが変更された場合、レビュー用のイシューが作成されます。
• ポリシーのソースURLの追跡 — 各サービスには、公式のポリシーページへのリンクが含まれた rules/ ディレクトリ内のソースファイルがあります。
• コンプライアンスエクスポート — GET /api/compliance-export は、追跡されているソース、ハッシュ、および保留中の候補変更のCSVスナップショットを返します（?format=json で機械可読な出力を取得できます）。
• バージョン管理されたルール — 各ルールファイルには、古さを検出するための rules_version フィールドが含まれています。

アーキテクチャ

• ステートレス — データベース、セッション、副作用がありません
• 決定論的 — 同じ入力は常に同じ出力を生成します
• バージョン管理されたルール — ルールファイルには変更を追跡するためのバージョンが含まれています
• 毎日の監視 — 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) — 無料トライアルの条件チェッカー
• すべてのサブドメインのホスト名ベースのミドルウェアルーティング
• キャンセル、返品、およびトライアルポリシーのポリシーソースファイルと毎日のチェック
• ランディングページでのHumans/Agentsモードの切り替え
• 4つのサーバーすべてのカードを含むMCPカタログ

修正点:

• 毎日のポリシーチェッカー: contents:write パーミッションを追加し、シェルロジックを修正しました
• 404エラーを引き起こしていた無効なCloudflareのemail-decodeスクリプトを削除しました

v1.1.0 (2026-02-01)

追加された機能:

• サポートされるベンダーを64から100に拡張しました
• 毎日のポリシーチェックのGitHub Action（UTC 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つのベンダーのサポート

無料API（デフォルト: 認証不要）

4つのポリシーサーバーはすべて無料で使用できます。認証やAPIキーは必要ありません。

/api/decide はデフォルトで公開されており、サーバーの環境変数に DECIDE_API_KEY を設定することで保護することができます。

decide を動的な顧客キーを持つ decidesite プロキシの背後で実行する場合は、以下も設定してください:

• DECIDE_PROXY_SHARED_TOKEN: 信頼できるプロキシ呼び出しのために x-decide-proxy-token ヘッダーに必要な共有シークレット。
• DECIDE_API_KEY: 信頼できるプロキシが上流に転送するバックエンドの内部キー（バックエンドを非公開に保つことをお勧めします）。

レート制限: 1つの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 または @decidefyi on X までお問い合わせください。

📎 リンク

• ウェブサイト: 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

decide.fyi チームによって愛情を込めて作成されました