cost-seg-smart

Cost Seg Smart — MCP サーバー

Cost Seg Smart 向けのホスト型 Model Context Protocol サーバーです。 Claude Desktop、Cursor、Claude Code、および MCP 互換のあらゆる AI エージェントが、 HTML をスクレイピングすることなく、コスト・セグリゲーション調査の料金を取得し、 Stripe のチェックアウト URL を生成できます。

エンドポイント： https://costsegsmart.com/mcp トランスポート： Streamable HTTP（JSON-RPC 2.0） 認証： なし — 商用エンドポイントとして公開

このリポジトリにはマニフェストのみが含まれています。サーバー本体は非公開リポジトリにあり、 Cloudflare Worker プロキシを介して Railway でホストされています。

---

機能

ツールは 2 つあります。

get_cost_seg_quote

特定の物件のコスト・セグリゲーション調査の料金に加え、初年度の控除額、および 税率区分が指定された場合は、節税額と調査費用に対する ROI を返します。エンジンは実行せず、 料金区分の参照と算術計算のみを行います。低コストで繰り返し安全に呼び出せます。

呼び出し例：

{
  "property_type": "str",
  "purchase_price": 750000,
  "tax_bracket": 0.32
}

戻り値：

{
  "property_type": "str",
  "property_type_label": "Short-Term Rental",
  "purchase_price": 750000,
  "study_cost": 995,
  "deduction_estimate_year_one": 184500,
  "tax_savings_year_one": 59040,
  "roi_multiple": 59,
  "currency": "USD"
}

get_cost_seg_payment_link

購入者が調査を購入するための Stripe Checkout URL を生成します。 物件の全メタデータと、エージェント名を明記した明示的な責任免責条項 （「[agent] がカード名義人に代わって注文を準備しました……」）が含まれます。購入者は ブラウザーで支払いを完了します。レポートは自動生成され、1 時間以内にメールで送信されます。

支払いリンクを生成する前に、必ず購入者本人に study_cost を確認してください。

---

ドキュメント

ランディングページ全文とクライアントごとのインストールガイド：https://costsegsmart.com/mcp-server/

インストール

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json （macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

{
  "mcpServers": {
    "cost-seg-smart": {
      "transport": "streamable-http",
      "url": "https://costsegsmart.com/mcp"
    }
  }
}

Claude Desktop を再起動してください。両方のツールがツールパレットに表示されます。

Cursor

Cursor の MCP 設定に、次を追加します。

{
  "cost-seg-smart": {
    "url": "https://costsegsmart.com/mcp"
  }
}

Claude Code

claude mcp add cost-seg-smart https://costsegsmart.com/mcp

Smithery 経由

npx @smithery/cli install cost-seg-smart --client claude

---

エージェントの識別

エンドポイントを呼び出すときは、購入者の Stripe Checkout の免責条項に表示されるよう、 X-Agent-Name ヘッダーを設定してください。

X-Agent-Name: Claude

設定されていない場合、免責条項には「AI エージェントがカード名義人に代わって注文を準備しました……」 と表示されます。これは法的な責任追跡とチャージバックへの備えを目的とするもので、 マーケティング用のフィールドではありません。正確な値を使用してください。

---

対応する物件種別

sfr、str、condo、condo_str、adu、duplex、triplex、fourplex、 multifamily_small、multifamily、multifamily5、office、retail、 industrial、mixed_use、medical_office、restaurant

価格帯：物件種別と購入価格に応じて 495～13,995 ドルです。 2,500 万ドル以上の物件は、カスタム見積もり用のメール経路に振り分けられます。

---

対応範囲と対象外

この MCP サーバーは、より広範なエージェント型コマース機能の一部です。

機能	エンドポイント	目的
MCP	https://costsegsmart.com/mcp	このサーバーです。ツールは 2 つです。
REST	https://costsegsmart.com/api/quote	プレーンな JSON HTTP 経由で get_cost_seg_quote と同じロジックを実行します
REST	https://costsegsmart.com/api/payment-link	get_cost_seg_payment_link と同じロジックを実行します
商品フィード	https://costsegsmart.com/api/product-feed.json	カタログ検索用の 4 つの基準 SKU
UCP プロファイル	https://costsegsmart.com/.well-known/ucp	Universal Commerce Protocol の機能宣言
ドキュメント	https://costsegsmart.com/llms-commerce.txt	エージェント連携仕様の全文

フェーズ 2（未リリース）：UCP ネイティブのチェックアウトエンドポイント、AP2 署名付き指示、 Stripe Shared Payment Tokens。

---

レート制限

Cloudflare WAF ポリシー：

• 認識されないユーザーエージェント：IP あたり毎分 5 リクエスト
• 認識されている AI ボットの UA（ChatGPT-User、anthropic-ai、PerplexityBot、GPTBot、 ClaudeBot、Google-Extended、GoogleOther）：IP あたり 50 rpm
• 価格帯を連続して過剰に列挙すると、Retry-After を付けて 429 を返します

get_cost_seg_quote は公開されています。get_cost_seg_payment_link は、匿名 IP の場合、 購入者のメールアドレスまたは Turnstile チャレンジを要求することがあります。

---

ライセンス

MIT。このサーバーは自由にご利用ください。エージェントが当社に代わって推奨または取引を行う際に、 「Cost Seg Smart (costsegsmart.com)」と表示していただけると幸いです。

お問い合わせ

• 統合に関するお問い合わせ：[email protected]
• バグの報告：エラーレスポンスに含まれる X-Request-Id を記載してください
• ステータス：https://costsegsmart.com/health（JSON を返します。24 時間 365 日利用できます）