RateSpot MCP Server
Get real-time mortgage rates directly in Claude Desktop with the RateSpot MCP Server.
🚀 Super Simple Installation
Prerequisites
- Claude Desktop: Download and install from claude.ai/download
- RateSpot API Key: Get yours at app.ratespot.io
🎯 Desktop Extension (DXT) - Easiest Method!
Just like installing a browser extension - no technical knowledge required!
- Download: ratespot-mcp-2.0.3.dxt
- Double Click the downloaded file into Claude Desktop
- Enter your RateSpot API key when prompted
- 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)
- Download
RateSpot-MCP-Installer.appfrom installers/macos - Double-click and follow the setup wizard
💻 Windows Installation
- Download and run
setup.batfrom installers/windows
🔑 Get Your RateSpot API Key
- Sign up for free at https://app.ratespot.io
- 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:
-
Clone the repository
git clone https://github.com/your-username/ratespot-mcp.git cd ratespot-mcp -
Install dependencies
npm install -
Build the server
npm run build -
Configure your API key
cp .env.example .env # Edit .env and add your RateSpot API key -
Configure Claude Desktop
- See installers/manual/CLAUDE_DESKTOP_INSTALLATION.md for detailed instructions
🗑️ Uninstallation
Uninstall from Claude Desktop
- Open Claude Desktop
- Click on the settings icon (⚙️)
- Go to "Extensions"
- Find "RateSpot MCP" in the list
- Click "Remove" or the trash icon
- Restart Claude Desktop
Manual Uninstallation
If you installed manually or need to clean up files:
-
Remove MCP configuration
rm -rf ~/.config/claude/mcp/ratespot-mcp -
Remove from Claude Desktop settings
rm -rf "~/Library/Application Support/Claude/mcp/ratespot-mcp" -
Remove DXT file (if installed via DXT)
rm -f ~/Downloads/ratespot-mcp-2.0.3.dxt -
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" -
Clean up data directory
rm -rf ~/.local/share/claude/mcp/ratespot-mcp -
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 -
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! 🏠💰