# RateUpdate MCP

> RateUpdate gives your AI agent instant access to complex, real-time financial market data. It lets you query current mortgage rates, compare loan programs across multiple lenders, and track historical rate movements without leaving your chat window. Stop cross-referencing websites; start asking questions.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** rateupdate, mortgage-api, loan-pricing-automation, real-time-rates, secondary-market-manage, bbm-technologies, loan-programs-tracking, financial-market-analytics, mcp

## Description

Listen up. If you're dealing with mortgage rates, you know cross-referencing a dozen websites is a nightmare. This RateUpdate MCP Server plugs your AI agent directly into real-time financial data. You stop bouncing between tabs; you just ask questions and get answers straight through your chat window. It handles the heavy lifting of complex rate comparisons so you don't have to.

Here's what you can make your agent do with this setup. 

**Checking System Health & Alerts:** First, it lets you check the connection itself; running `check_rateupdate_status` verifies that the API is active and working right now. You also need to know about rate change alerts: use `list_alerts` to pull up a list of every rate change notification already set up on your account.

**Getting an Overview:** If you just want the lay of the land, start by running `list_rates`. That tool spits out a summary of all current, active rates across the entire market. For programs, you can get a quick rundown using `list_programs`, which lists every available loan program and its general parameters for a fast review. When you need to narrow it down further on eligibility, use `get_program` to fetch deep details—including requirements—for any single listed loan program.

**Finding the Players:** Need to know who's in the game? Run `list_lenders` and you get a complete list of every participating mortgage lender accessible through the system. If you want specific intel on one company, just give it their name or ID with `get_lender`, and the agent pulls up all their detailed info.

**Comparing & Deep Diving into Rates:** This is where the money is made. To compare current rates across multiple lenders for a given program, run `compare_rates`. That function gathers real-time quotes from different sources, showing you the lowest rate available and any associated points. If you're already locked onto a specific product and lender—say, the 30-year fixed at Lender X—you use `get_rate` to nail down exact figures like the APR or the required fixed payment.

**Tracking History:** Rates don't just appear; they move. To figure out how volatile the market is, you can run `get_trends`. You specify a timeframe—maybe 'last 30 days,' or 'quarterly view'—and the agent returns historical data showing exactly how that specific rate moved over time.

**It's all about context.** The system lets your agent analyze loan program eligibility by listing programs via `list_programs` and providing detailed requirements through `get_program`, letting you confirm if a client actually qualifies for certain options. You can pull up the full list of lenders with `list_lenders` or drill down on specifics with `get_lender`. If you're just starting out, running `list_rates` gives you the market snapshot; if you need to compare multiple sources, `compare_rates` gets you the side-by-side view. You can confirm everything is working by checking the status using `check_rateupdate_status`, and when a rate shifts in a way that matters to you, your existing alerts fire through `list_alerts`. This setup turns complex financial lookups into simple conversational commands. You'll be running these queries faster than you thought possible.

## Tools

### check_rateupdate_status
Verifies if the API connection is active and working correctly right now.

### compare_rates
Compares current mortgage rates for a given loan program across multiple lenders.

### get_lender
Retrieves detailed information about a specific lender by name or ID.

### get_program
Fetches the full details, including requirements, for a single loan program.

### get_rate
Retrieves specific rate details (like APR or fixed payment) when you know the exact product and lender.

### get_trends
Gathers historical data to show how a specific rate has changed over time in defined periods.

### list_alerts
Shows you all the rate change alerts that are currently set up and active on your account.

### list_lenders
Provides a complete list of participating mortgage lenders accessible through the system.

### list_programs
Lists all available loan programs and their general parameters for quick review.

### list_rates
Gets a summary list of current, active mortgage rates across the market.

## Prompt Examples

**Prompt:** 
```
Show me current mortgage rates.
```

**Response:** 
```
Here are 12 current rates. The best 30-year fixed is 6.25% from LenderA. The 15-year fixed starts at 5.75%. Would you like to compare rates for a specific program?
```

**Prompt:** 
```
Compare rates for program prg_30yr_fixed.
```

**Response:** 
```
Comparing 5 lenders for 30-Year Fixed: LenderA (6.25%), LenderB (6.375%), LenderC (6.50%). LenderA offers the lowest rate with 0.5 points.
```

**Prompt:** 
```
Show rate trends for the last 30 days.
```

**Response:** 
```
Over the last 30 days, the 30-year fixed rate dropped from 6.75% to 6.25% (-0.50%). The biggest daily drop was -0.125% on the 15th.
```

## Capabilities

### Compare Rates Across Programs
The agent gathers real-time rates from multiple lenders for a specific loan program, showing you the lowest available rate and associated points.

### Track Rate History
You specify a time frame (e.g., 'last 30 days'), and the agent returns the historical movement of key mortgage rates.

### Analyze Loan Program Eligibility
The system lists available loan programs and provides detailed requirements, letting you confirm if a client qualifies for certain options.

### Identify Lender Details
You ask for details on a specific lender or want to see a list of all participating lenders in the market.

### Monitor System Status and Alerts
The agent checks the API connection status or lists existing rate change alerts configured within your account.

## Use Cases

### A client asks for immediate rate comparison.
A loan officer needs to quote rates fast. They ask their agent, 'Compare 15-year fixed rates.' The agent runs `compare_rates` and instantly returns a list showing the lowest available rate from three different lenders.

### Advise on market timing.
A financial analyst is worried about pricing. They ask, 'How did the 30-year fixed rate perform in the last six months?' The agent uses `get_trends` to show a clear graph of movement, helping them advise the client on whether to wait or buy now.

### Verify program eligibility.
A broker has a potential buyer with unique income requirements. They ask the agent to 'Check jumbo loan programs.' The agent runs `list_programs` and uses `get_program` to pull up specific rules, confirming if the buyer qualifies.

### Troubleshoot data access.
A new team member is running reports. Before they start, they ask the agent to 'Check API status.' The agent runs `check_rateupdate_status`, immediately verifying that the connection is good and saving time.

## Benefits

- Stop guessing if a rate is good. Use `get_trends` to see exactly how the 30-year fixed rate moved over the last quarter, giving you historical context instantly.
- Never waste time comparing spreadsheets. The `compare_rates` tool pulls live data from multiple lenders for one program so your agent gives you a clear winner in seconds.
- Know what's available immediately. Instead of browsing dozens of lender sites, use `list_programs` to see every qualifying loan product right through the chat interface.
- Instant operational checks: Use `check_rateupdate_status` before running anything major. It confirms your API connection is live and ready for heavy usage.
- Full market visibility: The combined power of `list_lenders` and `list_rates` lets you get a high-level snapshot of who's in the game and what the general pricing looks like today.

## How It Works

The bottom line is your agent runs the complex API calls internally; you just talk to it normally.

1. Tell your AI client exactly what data you need—for example, 'Compare 30-year fixed rates for a jumbo loan.'
2. The agent identifies the necessary tools (`compare_rates`, `list_programs`) and executes them in sequence, passing parameters like program IDs and lender names.
3. You receive a structured response that compares rates side-by-side, detailing who offers what rate and what points are involved.

## Frequently Asked Questions

**How do I know if rates are current when using RateUpdate? **
You should always start by running the `check_rateupdate_status` tool. This verifies that the API connection is live before you proceed with any rate comparisons or trend analysis.

**What is the difference between list_rates and compare_rates? **
`list_rates` gives you a general market overview of current rates across all options. `compare_rates` requires you to select a specific program and compares that rate against multiple lenders.

**Can I check historical trends with RateUpdate? **
Yes, use the `get_trends` tool. You provide the target rate and the time period (e.g., last 90 days), and it returns the movement data.

**Do I need to know a lender's ID for all tools? **
No. For initial lookups, you can use `list_lenders` to find names first. Then, if needed, you can run `get_lender` with the name or ID.

**How does the `check_rateupdate_status` tool verify connectivity for RateUpdate?**
It runs a basic API handshake to confirm your credentials and connection path. A successful status means the service is up, giving you confidence before running complex queries.

**If I use `get_rate` with invalid identifiers (like an unknown program ID), how does RateUpdate handle the error?**
It returns a structured API error object instead of failing. This allows your AI client to read the specific failure code and tell you exactly what input needs fixing.

**What are the rate limits when using multiple tools like `list_lenders` and `list_programs` in sequence?**
The API enforces usage tiers, typically limiting calls to prevent abuse. We recommend batching your requests or checking the official documentation for exact call quotas per minute.

**When using the `list_alerts` tool, what specific parameters define rate changes that trigger an alert?**
You must specify the criteria: the target loan program ID, a comparator lender, and the minimum percentage change required to flag it. This defines the rule set for monitoring.

**Can my AI compare mortgage rates across lenders?**
Yes. Use `compare_rates` with a program ID to see side-by-side rate comparisons from all available lenders.

**How do I track rate trends over time?**
Use `get_trends` with the number of days to analyze. The agent returns historical rate data with daily changes.

**Can I see details of a specific loan program?**
Yes. Use `get_program` with the program ID. The agent returns eligibility criteria, rate tiers, and lending guidelines.