RateSpot MCP Server

Get real-time mortgage rates directly in Claude Desktop with the RateSpot MCP Server.

🚀 Super Simple Installation

Prerequisites

1. Claude Desktop: Download and install from claude.ai/download

2. RateSpot API Key: Get yours at app.ratespot.io

🎯 Desktop Extension (DXT) - Easiest Method!

Just like installing a browser extension - no technical knowledge required!

1. Download: ratespot-mcp-2.0.3.dxt

2. Double Click the downloaded file into Claude Desktop

3. Enter your RateSpot API key when prompted

4. Done! Start asking about mortgage rates immediately

No Node.js, no Terminal, no configuration files needed!

📖 **Complete DXT Installation Guide**

> Note: Version 2.0.3 adds foreclosure listings search with interactive map visualization, streaming support for handling long-running requests, and exposes all CSV/file management tools in the streaming server.

Alternative Installation Methods

⚡ One-Click Terminal Installation (macOS)

curl -fsSL https://raw.githubusercontent.com/zad0xlik/ratespot-mcp/main/installers/macos/quick-install.sh | bash

🖱️ GUI Installation (macOS)

1. Download `RateSpot-MCP-Installer.app` from installers/macos

2. Double-click and follow the setup wizard

💻 Windows Installation

1. Download and run `setup.bat` from installers/windows

🔑 Get Your RateSpot API Key

1. Sign up for free at **https://app.ratespot.io**

2. Get your API key from **Account Settings**

Installing via Smithery

To install RateSpot MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @zad0xlik/ratespot-mcp --client claude

Start Using

Ask Claude about mortgage rates! Try questions like:

*"Can you get current mortgage rates for a $400,000 loan?"*

✨ What You Can Do

Once installed, you can ask Claude to:

• Get Current Rates: "What are today's mortgage rates for a $500K loan?"
• Search Foreclosures: "Show me foreclosure listings within 10 miles of 94949"
• View Property Maps: "Display foreclosures on an interactive map"
• Compare Loan Products: "Compare 15-year vs 30-year mortgages for my situation"
• Calculate Payments: "Calculate monthly payment for $400K at 6.5% interest"
• Analyze Market Trends: "Show me rate trends for the past 30 days"
• Pre-qualify: "Can I qualify for a loan with 750 credit score and $80K income?"

📚 Additional Documentation

• **Installation Guides** - Detailed installation instructions and troubleshooting
• **User Guides & Features** - Complete feature documentation and usage examples
• **Manual Setup Instructions** - Step-by-step manual configuration for Claude Desktop and Cline

🛠️ For Developers

• **API Documentation** - Technical API reference
• **Testing Guide** - Test files and validation scripts
• **Examples** - Usage examples and sample code
• **Sample Data** - Example CSV and JSON data files

🔧 Manual Installation

If you prefer to install manually or need to customize the setup:

1. Clone the repository

git clone https://github.com/your-username/ratespot-mcp.git
   cd ratespot-mcp

2. Install dependencies

npm install

3. Build the server

npm run build

4. Configure your API key

cp .env.example .env
   # Edit .env and add your RateSpot API key

5. Configure Claude Desktop

🗑️ Uninstallation

Uninstall from Claude Desktop

1. Open Claude Desktop

2. Click on the settings icon (⚙️)

3. Go to "Extensions"

4. Find "RateSpot MCP" in the list

5. Click "Remove" or the trash icon

6. Restart Claude Desktop

Manual Uninstallation

If you installed manually or need to clean up files:

1. Remove MCP configuration

rm -rf ~/.config/claude/mcp/ratespot-mcp

2. Remove from Claude Desktop settings

rm -rf "~/Library/Application Support/Claude/mcp/ratespot-mcp"

3. Remove DXT file (if installed via DXT)

rm -f ~/Downloads/ratespot-mcp-2.0.3.dxt

4. Remove DXT streaming server file

rm -f "/Users/[username]/Library/Application Support/Claude/Claude Extensions/local.dxt.ratespot.ratespot-mcp/server/ratespot_mcp_server_streaming.js"

5. Clean up data directory

rm -rf ~/.local/share/claude/mcp/ratespot-mcp

6. Update Claude Desktop config file

# Config file location: ${HOME}/Library/Application Support/Claude/claude_desktop_config.json
   # Open the file in your preferred editor and remove the ratespot-mcp entry from the extensions section

7. Check and kill any running server processes

# Check if anything is running on port 3001
   lsof -i :3001
   # If a process is found, kill it using its PID
   kill $(lsof -t -i:3001)

After uninstallation, restart Claude Desktop to ensure all changes take effect.

🆘 Need Help?

• Installation Issues: Check docs/installation/ for troubleshooting guides
• Usage Questions: See docs/guides/ for feature documentation
• API Problems: Visit RateSpot.io Support

📄 License

MIT License - see LICENSE file for details.

Ready to get started? Download the installer for your platform and you'll be getting mortgage rates in Claude within minutes! 🏠💰