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 up

Option 2: Local installation

npm install
npm start

Tools

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 price
• down_payment (required): Down payment as "20%" or 50000
• interest_rate (optional): Annual rate %. If omitted, fetches latest from Home Slice
• loan_term_years (optional): Loan term, default 30
• property_tax_annual (optional): Annual property tax
• home_insurance_annual (optional): Annual insurance premium
• hoa_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"]
    }
  }
}