# NCREIF MCP > NCREIF connects your AI agent directly to authoritative institutional commercial real estate data. Track property performance, calculate fund returns, and benchmark market indices—all from natural conversation. You can list properties, check regional metrics, or pull granular index history using dedicated tools like get_property_returns and list_indices. ## Overview - **Category:** real-estate - **Price:** Free - **Tags:** commercial-real-estate, property-performance, fund-returns, market-indices, investment-fiduciaries ## Description You're connecting your agent to **NCREIF**, giving you direct access to institutional commercial real estate data. Forget wading through spreadsheets—you can pull core market intelligence, calculate fund returns, and benchmark property performance using nothing but natural conversation. This server equips your AI client with tools that talk directly to the NCREIF database. **Getting Started: Listing Everything You Need to Know** You don't know what data exists? No sweat. You can run `list_properties` to get a full inventory of every indexed commercial property available in the system. If you need to check on investment funds, use `list_funds` for a definitive list of all tracked real estate investments. Want to see which benchmarks you're dealing with? `list_indices` provides the official roster of primary NCREIF performance indices (like the NPI or ODCE). To understand what metrics are even available across the board, run `list_data_series`. This tool gives you a list of all granular data categories—think 'Occupancy Rate' or 'Cap Rate'—that you can query later. For high-level market context, `list_market_data` shows general metrics and data categories for broader analysis. **Analyzing Specific Assets and Funds** Need to see how a specific asset stacks up? Use `get_property_returns`. This calculates and returns the historical total return, income metrics, and appreciation figures for any indexed commercial property you specify. You can segment this deeper: use `get_property_type_data` to aggregate performance based on building type—whether it's **Office**, **Retail**, or **Industrial**. Similarly, if you want a view of the market in a specific spot, run `get_region_data`. This pulls aggregated market and performance metrics for any given geographical region. For investment funds, start by listing them with `list_funds`, then use `get_fund_performance` to pull detailed performance history and returns for that targeted fund. **Benchmarking the Market** Tracking industry benchmarks is critical. You can fetch time-series data and full performance reports for established indexes like NPI or ODCE using `get_index_data`. This tool retrieves comprehensive, deep metrics for a named NCREIF performance index over historical periods. When you need to understand the broader market picture—the general health of real estate investments across multiple areas—`list_market_data` gives you the categories you're working with. **A Quick Workflow Example** You can pull a list of all indexed properties via `list_properties`. Then, if you want to check on the performance of just those office buildings in the Northeast region, you combine tools: first, use `get_region_data` for 'Northeast', and then filter that data using `get_property_type_data` for 'Office'. If you're trying to see how a specific fund has done over five years, you simply call `get_fund_performance`. You never have to guess what data is available; the listing tools guide you. Everything from single-property metrics to entire index histories flows right through your agent. ## Tools ### get_fund_performance Pulls specific performance history and returns for a targeted real estate investment fund. ### get_index_data Retrieves detailed, time-series data for a named NCREIF performance index (e.g., the NPI). ### get_property_returns Calculates and returns historical total, income, and appreciation metrics for a specific indexed property. ### get_property_type_data Gathers aggregated performance data filtered by building type (Office, Retail, Industrial). ### get_region_data Provides aggregate market and performance metrics for a specific geographical region. ### list_data_series Lists all available, granular data categories (like 'Occupancy Rate' or 'Cap Rate') you can query later. ### list_funds Generates a list of all tracked real estate investment funds in the NCREIF database. ### list_indices Provides a definitive list of primary NCREIF performance indices (e.g., NPI, ODCE). ### list_market_data Lists high-level market data categories and general metrics available for analysis. ### list_properties Returns a list of all individual indexed commercial properties available in the database. ## Prompt Examples **Prompt:** ``` List all commercial real estate indices available via NCREIF. ``` **Response:** ``` I've retrieved the available indices. You have access to several primary benchmarks including the NPI (Property Index), the ODCE (Fund Index), and various regional sub-indices. Would you like to see the historical performance data for the NPI? ``` **Prompt:** ``` Show me the performance data for the 'Office' property type. ``` **Response:** ``` Retrieving data for property type 'Office' (ID: type_off)... In the last quarter, the total return was 1.2%, with income return at 1.1% and appreciation at 0.1%. Shall I compare this with the 'Industrial' property type performance? ``` **Prompt:** ``` What is the recent performance history for the ODCE Fund Index? ``` **Response:** ``` Fetching data for the ODCE Index... For the trailing 12 months, the ODCE index returned 5.4%. The current market value of assets tracked by this index is over $300 billion. Would you like a breakdown of returns by fund size? ``` ## Capabilities ### Analyze fund performance metrics Calculate historical returns for specific real estate investment funds using the get_fund_performance tool. ### Retrieve market index history Fetch time-series data and performance reports for established benchmarks like NPI or ODCE via get_index_data. ### Evaluate individual property returns Get detailed historical performance metrics (income, appreciation) for any indexed commercial property using get_property_returns. ### Segment data by region or type Filter market insights to view aggregated performance based on specific geographic regions or building types (e.g., Office vs. Retail). ### List available assets and funds Quickly retrieve lists of all indexed properties, investment funds, or general market data categories using list_properties, list_funds, or list_market_data. ## Use Cases ### A Portfolio Manager needs a quick benchmark check. The PM is reviewing quarterly reports and needs to compare their fund's performance against the sector average. Instead of pulling up the NCREIF portal, they ask their agent: 'What was the NPI return last quarter?' The agent uses `get_index_data` and provides the number instantly, allowing them to write the executive summary immediately. ### A Real Estate Analyst is comparing property types. An analyst needs to know which building type—Office or Retail—performed better in a specific metro area. They ask the agent to run `get_property_type_data` for both categories and compare the total returns, getting an immediate side-by-side comparison without needing multiple API calls. ### An Investment Researcher needs data taxonomy. A researcher is building a new model but isn't sure what specific metrics NCREIF tracks. They run `list_data_series` first to see every available metric (e.g., 'Year-over-year growth,' 'Cap Rate'). This guides their modeling inputs, preventing them from missing key data points. ### A User needs a historical comparison for a fund. The user wants to track the performance of a specific private equity fund. They ask the agent to run `get_fund_performance` on that fund's ID and request data spanning 5 years, getting an immediate visualization or detailed table showing the required history. ## Benefits - **Stop manually logging in.** You pull complex data sets—like the ODCE Fund Index history via `get_index_data`—directly into your chat window. No more switching tabs or coping/pasting CSVs. - **Compare apples to oranges (or Office to Retail).** Use `get_property_type_data` and `get_region_data` together. You can ask the agent: 'How did Industrial compare to Office in this zip code?' and get a single, synthesized answer. - **Pinpoint performance drivers.** Need to know why one fund is doing better? Use `list_funds` first, then run `get_fund_performance` on specific titles. It cuts the research time from hours to seconds. - **Build models without data hunting.** Forget guessing what metrics are available. Run `list_data_series` and see every single granular metric NCREIF tracks—from cap rates to vacancy counts—before you write a line of code. - **Get asset details on demand.** Instead of listing hundreds of properties, use `get_property_returns` with just the property ID. You get immediate total return data without wading through massive spreadsheets. ## How It Works The bottom line is that your AI client handles all the API calls; you just ask it questions in natural language. 1. Subscribe to the NCREIF server and enter your unique NCREIF API Key. 2. Ask your AI client a specific question—for example: 'What was the return for Office properties in Q1?' 3. Your agent calls the appropriate tool (like get_property_type_data), retrieves the data, and gives you a plain-English answer. ## Frequently Asked Questions **How do I find out what indices are available using list_indices?** Run `list_indices` first. This returns the definitive list of all primary NCREIF benchmarks, like the NPI and ODCE. After you pick one, use `get_index_data` to pull its historical performance. **Can I compare different property types? Which tool do I use for that?** Yes, use `get_property_type_data`. This tool lets you group and get comparative performance data across building categories like 'Office' versus 'Retail' in one call. **What if I want to track a fund that isn't listed?** This server relies on NCREIF's indexed data. If the fund isn't cataloged, you won't be able to use `get_fund_performance`. First, check the list using `list_funds`. **How do I get performance by a specific geography?** You must use the `get_region_data` tool. You'll need to specify the region ID or name when querying for metrics like regional returns. **What credentials do I need to use get_index_data?** You must provide a valid NCREIF API Key during setup. This key authorizes your AI client to access the data endpoint, ensuring secure connections for every query you run. **How can I check which specific metrics are available using list_data_series?** Running `list_data_series` shows all granular categories. This lets you see every specific metric—like income yield or cap rate—before attempting a complex data retrieval query. **If I use get_property_returns and provide an invalid property ID, what error should I expect?** The tool will return a specific 'Not Found' message. Always verify the unique property identifier before running the function to prevent failed calls and save time. **Are there rate limits when querying list_market_data frequently?** Yes, query rates are managed by Vinkius. We recommend batching related data calls or implementing a brief pause between executions to avoid throttling errors. **How do I get an NCREIF API Key?** NCREIF API access is typically provided to member organizations. You can find or request your API key through the NCREIF Member Portal or by contacting their data services team. **What is the difference between NPI and ODCE indices?** The NPI (NCREIF Property Index) tracks the performance of individual institutional properties, while the ODCE (Open End Diversified Core Equity) tracks the performance of diversified real estate funds. **Can I filter data by property type?** Yes! Use the `get_property_type_data` tool to retrieve performance metrics specifically for categories like Office, Industrial, Retail, or Apartment.