Home Slice MCP Server
MCP server that provides mortgage calculation tools with live interest rates from Home Slice.
Features
- Fetch latest 30-year and 15-year mortgage rates from Home Slice
- Calculate monthly payments including principal, interest, taxes, insurance, and HOA
- Support for down payment as percentage or dollar amount
- Automatic rate fetching or manual rate input
- Comprehensive cost breakdown
Installation
Option 1: Docker
# Build the image
docker build -t home-slice-mcp .
# Run the container
docker run -i home-slice-mcp
# Or use docker-compose
docker-compose upOption 2: Local installation
npm install
npm startTools
get_mortgage_rates
Retrieves the latest mortgage rates from Home Slice.
Returns:
- 30-year mortgage rate
- 15-year mortgage rate
- Last updated date
calculate_mortgage
Calculates monthly payment and total costs.
Parameters:
purchase_price(required): Home purchase pricedown_payment(required): Down payment as "20%" or 50000interest_rate(optional): Annual rate %. If omitted, fetches latest from Home Sliceloan_term_years(optional): Loan term, default 30property_tax_annual(optional): Annual property taxhome_insurance_annual(optional): Annual insurance premiumhoa_monthly(optional): Monthly HOA fees
Returns:
- Monthly breakdown (P&I, taxes, insurance, HOA)
- Total monthly payment
- Total interest paid
- Total cost of ownership
API Access
This project builds on the work of @thejoeosborne and his homeslice-public-api project.
You must request an API key to use this server. Get your API key at: https://www.homesliceapp.ai/api-access
Usage with Claude Desktop
Add to your claude_desktop_config.json:
Using Docker
{
"mcpServers": {
"home-slice-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"HOMESLICE_API_KEY='my-api-key-1238792837-598273498'",
"home-slice-mcp"
],
"env": {}
}
}
}Using local installation
{
"mcpServers": {
"home-slice-mcp": {
"command": "node",
"args": ["/path/to/home-slice-mcp/index.js"]
}
}
}
