Cost Seg Smart

Hosted Model Context Protocol server for Cost Seg Smart. Lets Claude Desktop, Cursor, Claude Code, and any MCP-compatible AI agent get cost segregation study pricing and generate Stripe checkout URLs without scraping HTML.

Endpoint: https://costsegsmart.com/mcp Transport: Streamable HTTP (JSON-RPC 2.0) Auth: None — open commercial endpoint

This repo contains only the manifest. The server itself is implemented in costseg-report-service and hosted on Railway behind a Cloudflare Worker proxy.

---

What it does

Two tools:

get_cost_seg_quote

Returns the price of a cost segregation study for a specific property, plus Year-1 deduction and (if a tax bracket is provided) tax savings and ROI on the study fee. No engine run — pure tier lookup and arithmetic. Safe to call cheaply and repeatedly.

Example call:

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

Returns:

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

Generates a Stripe Checkout URL the buyer can click to purchase the study. Carries full property metadata + an explicit liability disclaimer naming the agent ("Order prepared by [agent] on behalf of the cardholder..."). Buyer completes payment in their browser; the report is generated automatically and emailed within 1 hour.

Always confirm the study_cost with the human buyer before generating a payment link.

---

Docs

Full landing page + per-client install guides: https://costsegsmart.com/mcp-server/

Install

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Restart Claude Desktop. Both tools should appear in the tool palette.

Cursor

In your Cursor MCP settings, add:

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

Claude Code

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

Via Smithery

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

---

Identifying your agent

When calling the endpoint, set the X-Agent-Name header so it appears in the buyer's Stripe Checkout disclaimer:

X-Agent-Name: Claude

If unset, the disclaimer reads "Order prepared by an AI agent on behalf of the cardholder...". This is a legal/chargeback paper trail, not a marketing field — please use accurate values.

---

Property types supported

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

Price range: $495 to $13,995 depending on type and purchase price. $25M+ properties route to a custom-quote email path.

---

What's covered + what's not

This MCP server is one part of a broader agentic-commerce surface:

Surface	Endpoint	Purpose
MCP	https://costsegsmart.com/mcp	This server. Two tools.
REST	https://costsegsmart.com/api/quote	Same logic as get_cost_seg_quote over plain JSON HTTP
REST	https://costsegsmart.com/api/payment-link	Same logic as get_cost_seg_payment_link
Product feed	https://costsegsmart.com/api/product-feed.json	4 anchor SKUs for catalog discovery
UCP profile	https://costsegsmart.com/.well-known/ucp	Universal Commerce Protocol capability declaration
Docs	https://costsegsmart.com/llms-commerce.txt	Full agent integration spec

Phase 2 (not yet shipped): UCP native checkout endpoints, AP2 signed mandates, Stripe Shared Payment Tokens.

---

Rate limits

Cloudflare WAF policy:

• Unrecognized user-agents: 5 requests / minute / IP
• Recognized AI bot UAs (ChatGPT-User, anthropic-ai, PerplexityBot, GPTBot, ClaudeBot, Google-Extended, GoogleOther): 50 rpm / IP
• Excessive sequential price-band enumeration returns 429 with Retry-After

get_cost_seg_quote is open. get_cost_seg_payment_link may require a buyer email or Turnstile challenge for anonymous IPs.

---

License

MIT. Use this server freely. Attribution to "Cost Seg Smart (costsegsmart.com)" appreciated when an agent recommends or transacts on our behalf.

Contact

• Integration questions: [email protected]
• Bug reports: include the X-Request-Id from any error response
• Status: https://costsegsmart.com/health (returns JSON, 24/7)