MCP Server

1. Sign in to MortgageClarity and accept the disclaimer, if you haven't already.
2. Generate a personal access token from Dashboard → Tokens. Pick the narrowest scope you need — read is enough for asking questions about your data.
3. Add it to your MCP client's connector settings, or a config file:

{
  "mcpServers": {
    "mortgageclarity": {
      "type": "http",
      "url": "https://mortgageclarity.abhiraj.me/api/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

Treat the token like a password — anyone with it can act on your account within its scope. Revoke it anytime from the Tokens page.

Read — view-only

• list_profilesAll your mortgage profiles, with latest score summary.
• get_profileFull detail on one profile, including all stored inputs.
• get_scoreLatest Mortgage Health Score, grade, factors, and tips.
• get_amortization_summaryTime remaining, current balance, interest paid vs. remaining.
• run_payoff_scenarioHypothetical extra-payment scenario. Nothing is saved.
• run_affordability_checkHypothetical affordability check on arbitrary numbers. Nothing is saved.

Write — create and edit

• create_profileCreates a new mortgage profile with name, type, and inputs.
• update_profileEdits an existing profile's inputs (merged, not replaced).
• recalculate_scoreGenerates a fresh score from a profile's current inputs.

Unless a token has "auto-confirm writes" enabled, these ask for confirmation before making any change.

Delete — permanent removal

• delete_profilePermanently deletes a profile and its score history. Cannot be undone.