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:

npm install -g wrangler

Step 2: Log In to Cloudflare

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:

cd realitycents-mcp-cloudflare

Step 4: Install Dependencies

npm install

Step 5: Test Locally

npm start

Your server will start at http://localhost:8787/mcp. To verify it works, open a second terminal and run:

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

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:

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

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

... View full README on GitHub