# Cost Seg Smart — MCP Server

Hosted Model Context Protocol server for [Cost Seg Smart](https://costsegsmart.com).
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 lives in a private
repository and is 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:**

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

**Returns:**

```json
{
  "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):

```json
{
  "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:

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

### Claude Code

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

### Via Smithery

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