Sign Up

MCP Server

Configure and use the Property Forecast Model Context Protocol server for AI research assistants.

The Property Forecast MCP Server provides real estate market data tools for AI research assistants. It enables AI agents to search regions, retrieve market metrics, access historical trends, and fetch data through a standardized Model Context Protocol interface. 🤖

What is MCP?

Model Context Protocol (MCP) is a standard that allows AI assistants to interact with external data sources through a set of well-defined tools and resources. For example, it could be used to let ChatGPT search for flight prices and book a ticket on your behalf.

Setup Instructions

The Property Forecast MCP Server is available as a remote server. Configure it in your AI assistant's settings:

Claude

Note: You need a Claude Pro plan to use custom connectors.

  1. Go to Settings in Claude
  2. Navigate to Connectors or Custom Apps
  3. Create a new Remote MCP Server connector
  4. Configure with the following:
    • Host: https://propertyforecast.co/api/mcp
    • Client ID: 33ea93a8-0fa2-410a-8a66-01572728be9c
  5. Complete the OAuth authentication flow (should be self-explanatory)
  6. Enable the connector in a chat

ChatGPT

Note: You need ChatGPT Plus plan and Developer Mode enabled to use custom connectors.

  1. Go to Settings in ChatGPT
  2. Enable Developer Mode
  3. Navigate to Connectors or Custom Apps
  4. Create a new app
  5. Configure with the following:
    • Host: https://propertyforecast.co/api/mcp
    • Client ID: 94c0d4b4-17bb-4adf-b551-c824b5eb18c8
  6. Complete the OAuth authentication flow (should be self-explanatory)
  7. Enable the connector in a chat

Example Queries

Once the MCP server is enabled in your AI assistant, you can ask questions like:

  • "What are the top 10 markets for rental yield?"
  • "Show me historical price trends for San Francisco over the last 5 years"
  • "Find regions in California with median home prices under $500,000"
  • "What metrics are available for demographic analysis?"
  • "Compare rental yield and price appreciation for Miami and Austin"

Available Tools

The Property Forecast MCP server provides real estate market data tools:

Search Regions Tool

Search for regions by text, filter by metric values, and sort results.

Parameters:

  • q (optional): Search query for region name
  • type (optional): Filter by region type (metro, zip, etc.)
  • limit (optional): Maximum results (default: 25, max: 100)
  • sort (optional): Sort configuration object with metric (name or metric ID) and order (asc/desc). Defaults to population descending if omitted.
  • filters (optional): Array of metric filters with operator (<, =, >) and value

Get Region Tool

Retrieve comprehensive metadata and latest statistics for a specific region.

Parameters:

  • type (required): The region type
  • id (required): The region identifier (e.g., metro CBSA code, ZIP code)

List Metrics Tool

Discover available metrics for different categories.

Parameters:

  • category (required): Category to list - financials, market, or demographics

Get Historical Data Tool

Retrieve historical trends and time series data for regions and metrics.

Parameters:

  • type (required): The region type
  • id (required): The region identifier
  • metric (required): The metric ID to get historical data for
  • periods (optional): Array of months for percentage changes (default: [3, 12, 36, 60])
  • includeRaw (optional): Include raw time series data (default: false)

Authentication & Usage Limits

The MCP server uses OAuth authentication to allow secure access to Property Forecast data. You must be signed up for a Core plan or higher to access the MCP server. Usage is tracked and you can monitor your API consumption on the billing page.

Questions 👋

This is a new feature and feedback is welcome! For questions about setting up or using the Property Forecast MCP server, please contact us.