Cost Seg Smart — MCP Server
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": 895,
"deduction_estimate_year_one": 184500,
"tax_savings_year_one": 59040,
"roi_multiple": 66,
"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.
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:
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.