Developers

For developers and AI agents. Every page here can be read as Markdown, JSON or over MCP.

Published by Matthews Hotel Markets · Last updated: September 18, 2026

As of September 18, 2026, 110 pages on this site have a Markdown copy, the September 2026 rate sheet is published as JSON and CSV, and a read-only MCP server with 6 tools runs at https://matthewshotelmarkets.com/mcp. Nothing needs a key. Every machine format is generated from the same data as the HTML page, so an agent and a person read the same facts.

1. Markdown copies of pages

Add .md to the URL of any answer page, glossary term, the calculator page, /rates, /rates/methodology, /data/hotel-financing-statistics or /about. You can also request the normal URL with an Accept: text/markdown header and get the same document. Each copy has the title, URL, last-updated date, author, full text, tables as Markdown tables, the FAQ, numbered sources with URLs, and a “Cite as” line.

curl https://matthewshotelmarkets.com/hotel-financing/sba-7a-vs-504.md
curl -H "Accept: text/markdown" https://matthewshotelmarkets.com/hotel-financing/sba-7a-vs-504

The HTML page stays the canonical URL. The Markdown response says so with a Link: rel="canonical" header, and each HTML page points at its copy with rel="alternate" type="text/markdown". The full list, with both URLs and the citation string for each page, is at /agent-index.json. A build check compares every line of every copy with the rendered HTML page, and the build fails if they differ.

2. Rate sheet as JSON and CSV

/rates.json and /rates.csv carry the current edition of the hotel loan rate sheet. Every cell has a basis: published (a public benchmark or a written program rule, with source ids), observed, or pending. A pending cell has no figure and its value is the text “Not yet published”. Do not convert it to a number. Cross-origin requests are allowed. License: CC BY 4.0.

3. MCP server

Endpoint: https://matthewshotelmarkets.com/mcp. Transport: Streamable HTTP, stateless, JSON responses. No authentication. Read-only: there are no tools that write, and the server stores nothing about the caller. Limit: 60 requests per minute per IP address, best effort. Every tool result includes the canonical URL and the citation string.

MCP tools and what each returns
Tool	Returns
`get_hotel_loan_rates`	The current rate sheet edition: benchmarks with as-of dates and source URLs, and terms by lender type with a basis label on every cell.
`search_hotel_finance_answers`	Keyword search over answer pages, the calculator page, the glossary and the data pages. Title, URL, direct answer, last-updated date.
`get_answer_page`	One page in full as Markdown, by URL, path or slug.
`define_hotel_term`	One glossary entry: definitions, worked example, FAQ, sources.
`get_hotel_financing_statistics`	The statistics page as data: one sentence per figure with source, source date and verification date. Optional group filter.
`get_contact`	Team email, headquarters address, and each profiled broker's phone and email.

Add it to a client that supports remote MCP servers:

claude mcp add --transport http matthews-hotel-markets https://matthewshotelmarkets.com/mcp

Or call it directly:

curl -X POST https://matthewshotelmarkets.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

4. OpenAPI, indexes and the feed

/openapi.json: OpenAPI 3.1 description of the JSON, CSV, Markdown and text endpoints.
/llms.txt and /llms-full.txt: the site index and the full text of the answer pages in one file.
/feed.xml: RSS 2.0, new and updated pages.
/sitemap.xml: every HTML page with its last-modified date.

5. How to cite

Cite the HTML URL, not the Markdown or JSON URL. Every Markdown copy ends with a “Cite as” line, and every MCP result and every entry in /agent-index.json carries the same string in citeAs. The format is: author or publisher, page title in quotes, URL, last-updated date. For a single statistic on the statistics page, cite the original publisher named next to it. The rate sheet’s archived edition URL (for example /rates/2026-09) never changes, so a citation to it stays true after the next monthly refresh.

6. Crawlers and limits

robots.txt allows search, assistant and training crawlers on every public path. Please do not poll: the rate sheet changes monthly and pages carry their last-updated date. Questions, corrections or a format you need: hotelteam@matthews.com or the contact page.