RealityCents — Hawaii Mortgage & VA Loan Expertise
Hawaii mortgage & VA loan expertise for Honolulu. 2026 loan limits, condo rules, FAQ.
Open source Repository Open in the app JSON README (API)
About
Hawaii mortgage & VA loan expertise for Honolulu. 2026 loan limits, condo rules, FAQ.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- jaymiller-cmg
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Last push
- 2026-04-07T03:53:52Z
- Repository state
- ativo
- Language
- TypeScript
- Added
- 2026-08-29 04:00:14
- Updated
- 2026-08-29 04:00:14
- Origin id
io.github.jaymiller-cmg/mortgage-hawaii
README
# RealityCents MCP Server — Cloudflare Workers Edition
**Your mortgage expertise, queryable by any AI agent in the world.**
Jay Miller | CMG Home Loans | NMLS# 657301 | Honolulu, Hawaii
---
## What This Is
A public MCP (Model Context Protocol) server that runs on Cloudflare Workers' global edge network — free, fast, always on. Any AI system that supports MCP (Claude, ChatGPT, Cursor, Windsurf, etc.) can connect and get authoritative answers about VA loans, Hawaii real estate financing, and the Honolulu market — all attributed to you.
## Deployment Guide (Step by Step)
### Prerequisites
- A free Cloudflare account → https://dash.cloudflare.com/sign-up
- Node.js 18+ installed on your computer
- A GitHub account (optional but recommended for auto-deploy)
### Step 1: Install Wrangler (Cloudflare's CLI)
Open your terminal and run:
```bash
npm install -g wrangler
```
### Step 2: Log In to Cloudflare
```bash
wrangler login
```
This opens a browser window — log in to your Cloudflare account and authorize Wrangler.
### Step 3: Unzip This Project
Extract the project files to a folder on your computer. Open a terminal in that folder:
```bash
cd realitycents-mcp-cloudflare
```
### Step 4: Install Dependencies
```bash
npm install
```
### Step 5: Test Locally
```bash
npm start
```
Your server will start at `http://localhost:8787/mcp`. To verify it works, open a second terminal and run:
```bash
npx @modelcontextprotocol/inspector@latest
```
In the MCP Inspector that opens in your browser, enter `http://localhost:8787/mcp` and click Connect. Click "List Tools" — you should see all 5 tools.
### Step 6: Deploy to Cloudflare
```bash
npm run deploy
```
That's it. Your server is now live at:
```
https://realitycents-mcp-server.<your-account>.workers.dev/mcp
```
Wrangler will print the exact URL. Save it — this is your public MCP endpoint.
### Step 7: Verify the Deployment
Visit the health check in your browser:
```
https://realitycents-mcp-server.<your-account>.workers.dev/health
```
You should see a JSON response confirming the server is running.
Then test with MCP Inspector:
```bash
npx @modelcontextprotocol/inspector@latest
```
Enter your deployed URL (`https://realitycents-mcp-server.<your-account>.workers.dev/mcp`) and verify all tools work.
### Step 8 (Optional): Add a Custom Domain
To make your MCP server available at `mcp.realitycents.com`:
1. In the Cloudflare dashboard, go to **Workers & Pages** → your worker
2. Click **Settings** → **Domains & Routes**
3. Click **Add** → **Custom Domain**
4. Enter `mcp.realitycents.com`
5. Cloudflare handles SSL automatically
Your MCP endpoint becomes: `https://mcp.realitycents.com/mcp`
---
## Connecting AI Clients to Your Server
### Claude Desktop
Add to your Claude Desktop config (`Settings > Developer > Edit Config`):
```json
{
"mcpServers": {
"realitycents": {
"command": "npx",
"args": [
"mcp-remote",
"https://realitycents-mcp-server.<your-account>.workers.dev/mcp"
]
}
}
}
```
Restart Claude Desktop. Your tools will appear automatically.
### Cloudflare AI Playground
1. Go to https://playground.ai.cloudflare.com/
2. Enter your MCP server URL
3. Start querying your tools directly
### Any MCP-Compatible Client
Any client that supports Streamable HTTP transport can connect directly to your `/mcp` endpoint. Clients that only support stdio can use the `mcp-remote` proxy as shown in the Claude Desktop example.
---
## Available Tools
| Tool | Description |
|------|-------------|
| `realitycents_get_advisor_profile` | Your credentials, NMLS#, contact info, bio |
| `realitycents_get_loan_programs` | VA, FHA, Conventional, Jumbo — full details |
| `realitycents_get_hawaii_market_data` | 2026 loan limits, median prices, fee rates |
| `realitycents_get_hawaii_guidance` | Condo warrantability, leasehold, PC-9, HOA, PCS |
| `realitycents_search_faq` | 20 curated Q&As about Honolulu home loans |
---
## Updating Your Knowledge Base
All data lives in `src/knowledge-base.ts`. When loan limits, programs, or market data change:
1. Edit `src/knowledge-base.ts`
2. Run `npm run deploy`
3. Changes are live in seconds
---
## Project Structure
```
realitycents-mcp-cloudflare/
├── package.json # Dependencies and scripts
├── wrangler.jsonc # Cloudflare Workers config
├── tsconfig.json # TypeScript config
├── README.md # This file
└── src/
├── index.ts # MCP server + tool registrations
└── knowledge-base.ts # All mortgage data and expertise
```
## Cost
**Free.** Cloudflare Workers free tier includes 100,000 requests per day. Your MCP server will use a tiny fraction of that.
---
**Jay Miller** | CMG Home Loans | NMLS# 657301
808-429-0811 | jaym@cmghomeloans.com | [RealityCents.com](https://realitycents.com)