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

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: support@costsegsmart.com
• Bug reports: include the X-Request-Id from any error response
• Status: https://costsegsmart.com/health (returns JSON, 24/7)