# Mortgage Sourcing

> A UK mortgage-sourcing platform. This site is the public, AI-discoverable
> READ face — human product pages backed by a machine-readable REST API and
> a Model Context Protocol server for AI clients. Same data, three surfaces.

- Primary brand: Mortgage Sourcing (`https://www.mortgagesourcing.com/`)
- Purpose: compare live UK mortgage rates for humans + AI assistants
- Data model: `products` (typed columns + `attributes` JSONB) — every product
  page mirrors this shape as JSON-LD `FinancialProduct`
- "Rates as of" date is displayed on every product view and reflected in
  `sitemap.xml` `<lastmod>` + JSON-LD `dateModified`

## Actionable — Model Context Protocol (recommended for AI clients)

Tier-0 anonymous MCP endpoint:
`https://api.mortgagesourcing.com/mcp`

Transport: Streamable HTTP (no auth for public reads).

Tools:
- `search_products` — filter by rate type, LTV, loan size, term
- `compare_products` — side-by-side over two or more products
- `get_product` — full record including `attributes` JSONB
- `get_product_rates` — current rate + timestamp for one product

Setup + drop-in client config: `https://www.mortgagesourcing.com/connect`

## Structured — REST + JSON-LD

REST base: `https://api.mortgagesourcing.com/api/v1`

Enumerable read endpoints (Tier-0 anonymous):
- `GET /api/v1/products` — filter by the typed columns, paginated
- `GET /api/v1/products/{slug}` — full record including `attributes`

Every product page at `https://www.mortgagesourcing.com/products/{slug}`
carries an inline `<script type="application/ld+json">` with the shared
FinancialProduct mapping:

- `provider`                        ← lender
- `interestRate`                    ← `initial_rate`
- `loanTerm`                        ← `initial_period_months`
- `feesAndCommissionsSpecification` ← `attributes.fees`
- `description`                     ← `attributes.marketing_copy`
- `additionalProperty[]`            ← `attributes.features[]` + `attributes.ercs[]`
- `dateModified`                    ← `updated_at`

## Crawlable — no JS-only content

The whole site is SSG-prerendered by `@angular/build`'s static build. Every
route in `sitemap.xml` returns full HTML on first byte — no JavaScript
needed to see the content.

Sitemap: `https://www.mortgagesourcing.com/sitemap.xml`

## Trusted

- Read-only; the site never writes to `mortgages-api`.
- Rates are illustrative, not a recommendation. UK regulated content:
  "Your home may be repossessed if you do not keep up repayments on your
  mortgage."
- All product pages carry the visible "Rates as of DD MMM YYYY" trust line.

## The AI-discoverable web standard

This site is the reference implementation of the leartech
`ai-discoverable-websites` shared rule — the 5-layer stack
(Crawlable → Structured → Mapped → Actionable/MCP → Trusted).
Standard: `https://hub.leartech.com/shared-rules/ai-discoverable-websites`