cost-seg-smart

Cost Seg Smart — MCP 服务

面向 Cost Seg Smart 的托管式 Model Context Protocol 服务。 让 Claude Desktop、Cursor、Claude Code 以及任何兼容 MCP 的 AI Agent 都能获取 成本分摊研究的定价并生成 Stripe 结账 URL，无需抓取 HTML。

端点： https://costsegsmart.com/mcp 传输： Streamable HTTP（JSON-RPC 2.0） 身份验证： 无 — 开放的商业端点

此仓库仅包含清单。服务本身位于私有仓库中，通过 Cloudflare Worker 代理托管在 Railway 上。

---

功能

两个工具：

get_cost_seg_quote

返回特定房产的成本分摊研究价格，以及首年扣除额；如果提供了税级，还会返回税费节省额和研究费用的投资回报率。不会运行引擎 — 仅进行等级查询和算术计算。可放心低成本地重复调用。

调用示例：

{
  "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（“订单由 [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

---

标识你的 Agent

调用端点时，设置 X-Agent-Name 标头，使其显示在买家的 Stripe Checkout 免责声明中：

X-Agent-Name: Claude

如果未设置，免责声明将显示“订单由 AI Agent 代表持卡人准备……”。这是用于法律和拒付追踪的记录，而非营销字段 — 请使用准确值。

---

支持的房产类型

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

价格范围：$495 至 $13,995，具体取决于类型和购买价格。 $25M 及以上的房产将转至定制报价邮件流程。

---

涵盖内容和未涵盖内容

此 MCP 服务是更广泛的 Agent 商务体系的一部分：

入口	端点	用途
MCP	https://costsegsmart.com/mcp	此服务。两个工具。
REST	https://costsegsmart.com/api/quote	通过纯 JSON HTTP 提供与 get_cost_seg_quote 相同的逻辑
REST	https://costsegsmart.com/api/payment-link	提供与 get_cost_seg_payment_link 相同的逻辑
产品 Feed	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	完整的 Agent 集成规范

第 2 阶段（尚未发布）：UCP 原生结账端点、AP2 签名授权、Stripe Shared Payment Tokens。

---

速率限制

Cloudflare WAF 策略：

• 无法识别的 user-agent：每个 IP 每分钟 5 个请求
• 可识别的 AI 机器人 UA（ChatGPT-User、anthropic-ai、PerplexityBot、GPTBot、 ClaudeBot、Google-Extended、GoogleOther）：每个 IP 每分钟 50 个请求
• 过度连续枚举价格区间将返回 429 和 Retry-After

get_cost_seg_quote 开放使用。匿名 IP 调用 get_cost_seg_payment_link 时，可能需要买家邮箱或 Turnstile 验证。

---

许可证

MIT。可自由使用此服务。如果 Agent 代表我们推荐或完成交易，欢迎注明“Cost Seg Smart (costsegsmart.com)”。

联系方式

• 集成问题：[email protected]
• Bug 报告：请附上任何错误响应中的 X-Request-Id
• 状态：https://costsegsmart.com/health（返回 JSON，全天候可用）