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

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