4,500+ servers built on MCP Fusion
Vinkius

NCREIF Custom Query MCP. Analyze property indices and real estate performance data.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

NCREIF Custom Query MCP on Cursor AI Code Editor MCP Client NCREIF Custom Query MCP on Claude Desktop App MCP Integration NCREIF Custom Query MCP on OpenAI Agents SDK MCP Compatible NCREIF Custom Query MCP on Visual Studio Code MCP Extension Client NCREIF Custom Query MCP on GitHub Copilot AI Agent MCP Integration NCREIF Custom Query MCP on Google Gemini AI MCP Integration NCREIF Custom Query MCP on Lovable AI Development MCP Client NCREIF Custom Query MCP on Mistral AI Agents MCP Compatible NCREIF Custom Query MCP on Amazon AWS Bedrock MCP Support

Just plug in your AI agents and start using Vinkius.

NCREIF Custom Query allows your AI client to run custom SQL-like queries against institutional real estate data. It pulls performance metrics, historical index returns (NPI), Cap Rates, and occupancy stats from major US indices like NPI and ODCE.

Forget manual spreadsheet lookups; just ask your agent for the numbers you need.

What your AI agents can do

Execute query

Run a custom query to pull any data point from NCREIF that fits your criteria.

Get historical npi

Retrieves historical total return performance for the NPI index over time.

Get predefined kpi

Fetches standardized key metrics, such as Cap Rates and Occupancy percentages, using a simple request.

Calculate Total Returns

Run custom queries to calculate total returns based on income and appreciation data.

Access Historical Index Data

Get NPI historical return data over specific time ranges.

Retrieve Standard Metrics

Fetch predefined key performance indicators, like Cap Rates and Occupancy percentages.

Filter by Geography or Type

Limit query results using specific filters for region, CBSA, or property class.

Analyze Specific Indices

Target data from the NPI (Property Index) or ODCE (Fund Index).

Supported MCP Clients

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
+ other MCP clients
Free for Subscribers

Waiting for input…

AI Agent

NCREIF Custom Query: 3 Tools for Real Estate Data

These three tools let your AI client execute custom queries, retrieve NPI history, or fetch predefined KPI data points.

execute019d75db

execute query

Run a custom query to pull any data point from NCREIF that fits your criteria.

get019d75db

get historical npi

Retrieves historical total return performance for the NPI index over time.

get019d75db

get predefined kpi

Fetches standardized key metrics, such as Cap Rates and Occupancy percentages, using a simple request.

Choose How to Get Started

Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.

Build Your Own

Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.

  • Import from OpenAPI, Swagger, or YAML specs
  • Create Agent Skills with progressive disclosure
  • Deploy to edge with MCPFusion framework
  • Built in DLP, auth, and compliance on every call
  • Real time usage dashboard and cost metering
  • Publish to catalog or keep private
Start building

Make Your AI Do More

Start with NCREIF Custom Query, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.

  • Use this MCP plus 4,700+ others, all in one place
  • Add new capabilities to your AI anytime you want
  • Every connection is secured and compliant automatically
  • Track usage and costs across all your servers
  • Works with Claude, ChatGPT, Cursor, and more
  • New servers added to the catalog every week

What you can do with this MCP connector

You're gonna let your AI client run custom SQL-like queries against institutional real estate data using the NCREIF Query Tool API.

This server pulls performance metrics, historical index returns (NPI), Cap Rates, and occupancy stats from major U.S. indices like NPI and ODCE. You don't gotta manually look up spreadsheets; you just ask your agent for the numbers you need.

When you use execute_query, you can pull any data point from NCREIF that fits your criteria. This means you control the formulas when calculating total returns, whether it's based on income or appreciation data. You also get to filter results deep down by geography, like limiting a query to specific regions or CBSA areas, or narrowing it by property class.

For index analysis, get_historical_npi retrieves historical total return performance for the NPI index over time. This lets you track how the market performed across different periods and calculate returns based on those long-term data points.

To get quick reads on standard metrics, you use get_predefined_kpi. That tool fetches standardized key metrics with a simple request, pulling numbers like Cap Rates and Occupancy percentages. You can target specific indices using this system; it handles both the NPI (Property Index) and the ODCE (Fund Index).

If you need to crunch the actual mechanics of returns, execute_query lets you run custom queries to calculate total returns that combine appreciation figures with income data points. You can also pull specific performance metrics for a given property type or region by using detailed filtering clauses within this query function.

The capabilities cover accessing historical index data specifically from NPI over set time ranges. Beyond the indices, get_predefined_kpi provides immediate access to standardized key indicators like Occupancy percentages and Cap Rates through a streamlined request process. You can use any of these tools together; for instance, you might first run an execute_query to pull raw income data for a specific CBSA area, then follow up with get_predefined_kpi to check the current occupancy percentage for that same region.

The system supports analyzing multiple indices. You can target the NPI or the ODCE when requesting performance metrics. If you need to restrict your search results, you've got filters available for the property type and specific geographic areas within a given state or county. Every tool operates on institutional-grade data, ensuring that what your agent hands you is accurate real estate intelligence.

You can ask execute_query to calculate complex total returns based on multiple income streams and appreciation inputs simultaneously. This query function doesn't just pull data; it runs calculations for you against the NCREIF dataset. When checking historical performance, get_historical_npi provides a time series of the NPI index's total return history.

The process is direct: one tool does one thing. You use get_predefined_kpi when you need standard numbers—think Cap Rates or Occupancy percentages—without building a massive query. Meanwhile, execute_query handles everything else; it pulls the granular data points and runs custom logic against them. Whether you're looking at raw property performance for filtering by region or needing to compare NPI versus ODCE historical trends, your agent can handle it.

How NCREIF Custom Query MCP Works

  1. 1 First, you subscribe to this server and enter your required credentials: your NCREIF Username and Password.
  2. 2 Second, you instruct your AI client—say, 'What were the total returns for Q4 2025?'—and the agent maps that request to the appropriate tool.
  3. 3 Third, the server executes the query against institutional data and sends back clean, structured results (like JSON) directly into your chat or code environment.

The bottom line is you talk naturally to your agent, and it handles the complex API calls required for deep real estate analysis.

Who Is NCREIF Custom Query MCP For?

Real Estate Analysts who spend too much time in spreadsheets pulling historical data. Investment Managers needing quick comparisons across multiple US markets. Financial Modelers who need reliable, structured index data to back up their reports.

Investment Analyst

Uses the agent to compare Cap Rates and total returns across different property types or regions in a single query.

Portfolio Manager

Requests historical NPI data over several quarters to model market volatility and assess performance trends.

Real Estate Researcher

Runs ad-hoc queries against niche indices (like timberland) using the execute_query tool for deep, specific insights.

What Changes When You Connect

  • Run custom analytics: Instead of writing complex SQL, you just ask for 'total returns' or 'income appreciation.' The execute_query tool handles the logic.
  • Track history instantly: You get historical NPI performance without jumping through time-series dashboards. Just ask your agent to use get_historical_npi for a 4-quarter view.
  • Get standard KPIs fast: Need Cap Rates or Occupancy percentages? The get_predefined_kpi tool delivers these common metrics in one shot, saving clicks and time.
  • Filter by specific market conditions: You can force the query to look only at a certain region (CBSA) or property class using detailed filtering clauses within any tool.
  • Build complex reports easily: By chaining tools—first running get_predefined_kpi then refining with execute_query—you build complete financial narratives directly in your chat.

Real-World Use Cases

01

Q1 Market Checkup

A portfolio manager needs to know the Q1 performance of office space versus industrial properties. They ask their agent: 'What were the total returns for office vs. industrial in Q1?' The agent uses execute_query, filtering by property type and time, giving a direct comparison.

02

Modeling Volatility

An analyst needs to assess how NPI performed during recessions. They instruct the agent: 'Show me the historical NPI returns for 2008 through 2012.' The agent uses get_historical_npi, providing a clear, data-backed timeline.

03

Quick Due Diligence

A researcher needs to quickly check the current market health of a specific metro area. They prompt: 'What is the average Cap Rate in the Dallas CBSA?' The agent immediately calls get_predefined_kpi, bypassing hours of dashboard navigation.

04

Deep Dive Comparison

Someone needs to compare both historical trends and current metrics. They ask: 'Compare Q4 2025 NPI returns with the current average Cap Rate.' The agent intelligently calls both get_historical_npi and get_predefined_kpi, synthesizing a full answer.

The Tradeoffs

Asking for non-NCREIF data

User asks: 'What was the company's payroll budget last quarter?' The AI client fails because NCREIF only holds real estate index data, not internal corporate financials.

Keep your queries focused on institutional real estate indices. If you need to calculate total returns, use execute_query and specify all required financial metrics.

Vague time requests

User asks: 'Show me the trends.' The agent responds with an error because it needs a specific date range (e.g., quarter, year).

Be precise when calling historical tools. Use get_historical_npi and specify the exact time frame you need (e.g., 'last 4 quarters').

Overloading a single query

User attempts to calculate Cap Rate, total returns, AND filter by CBSA in one giant execute_query prompt that fails due to complexity.

Break it down. First, use get_predefined_kpi for the Cap Rate baseline. Then, run a focused execute_query using only the remaining filters.

When It Fits, When It Doesn't

Use this server if your job involves analyzing US institutional real estate indices (NPI, ODCE) and you need to calculate returns or check standardized metrics like Cap Rates. If your data source is proprietary company financials, payroll records, or non-real estate market data, don't use this. You'll get an error.

If you only need a simple list of current property types without historical context, manual searching might work. But if you need data—metrics, returns, or indexed numbers—this server is the best path. It offers specialized tools (get_historical_npi, get_predefined_kpi) for common tasks, but its power lives in the flexibility of execute_query when you need to combine multiple data points.

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by NCREIF. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

VINKIUS INFRASTRUCTURE

Cloud Hosted

Managed infra

V8 Isolated

Sandboxed per request

Zero-Trust Proxy

No stored credentials

DLP Enforced

Policy on every call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

How we secure it →

Works with Claude, ChatGPT, Cursor, and more

The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.

This server provides 3 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.

Available Capabilities

execute_query get_historical_npi get_predefined_kpi

Pulling market intelligence usually means opening a dozen browser tabs and juggling spreadsheets.

Today's process requires exporting index data from one dashboard, downloading it to Excel, writing the formulas for total return calculations, then filtering by region in a separate tool. It’s repetitive, slow, and easy to miscalculate.

With NCREIF Custom Query MCP Server, you just ask your agent: 'What was the Q4 2025 total return for industrial properties.' The server runs the complex query instantly—you get the number, period.

The NCREIF Custom Query MCP Server delivers real estate data insights.

Before this, getting a simple KPI like Cap Rate meant finding the right report, waiting for it to refresh, and manually checking if the number applied to your specific property class. It was friction-filled work.

Now, you ask the agent for the predefined KPI data directly. The server executes `get_predefined_kpi` in milliseconds, giving you a clean metric without any manual clicks or guesswork.

Common Questions About NCREIF Custom Query MCP

How do I use NCREIF Custom Query to calculate total returns? +

You use the execute_query tool. You simply tell your agent what metrics you want to combine (like income and appreciation) and which time frame, letting the server handle the underlying calculation logic.

Can I check historical NPI returns using get_historical_npi? +

Yes. The get_historical_npi tool fetches performance data for the NPI index over specific, defined periods (e.g., last 4 quarters), giving you a clear time-series breakdown.

What is the difference between get_predefined_kpi and execute_query? +

The get_predefined_kpi tool handles common, standardized metrics (Cap Rates, Occupancy) with simple calls. Use execute_query when you need to build custom reports or combine multiple non-standard data points.

Do I need credentials for NCREIF Custom Query? +

Yes. You must subscribe and provide your full NCREIF Username and Password so the agent can authenticate against the institutional data source.

When using `execute_query`, how do I apply specific filters, like by region or property type? +

You filter results by including powerful 'WHERE' clauses directly in your query string. You specify the criteria—for example, filtering properties only within a certain CBSA code. This allows you to narrow down large datasets efficiently.

If I run `execute_query` and encounter an error, how should I troubleshoot it? +

First, check your SQL-like syntax against the NCREIF documentation; most issues are simple typos or incorrect column names. If the syntax is correct, verify that the requested data index is accessible with your current credentials.

Does `get_historical_npi` provide returns for specialized indices, such as timberland or farmland? +

The get_historical_npi tool focuses specifically on major US real estate indices. For highly specialized metrics like timberland performance, you should use the custom query feature with execute_query.

What is the ideal format for the input parameters when writing a complex query via `execute_query`? +

The tool expects an SQL-like string that defines both your required metrics (e.g., 'income returns') and the necessary filtering conditions. Keep the language concise and highly specific to ensure accurate results.

Who can access this API? +

Access is limited to NCREIF Data Contributor Members and paid Data Subscribers. You must use your website login credentials.

More in this category

You might also like

Built & Managed by Vinkius 30s setup 3 tools

We've already built the connector for NCREIF Custom Query. Just plug in your AI agents and start using Vinkius.

No hosting. No infrastructure. No complex setup.
All 3 tools are live and waiting. You're up and running in seconds.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
+ other MCP clients

Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.

Zero hosting required Full MCP catalog included Enterprise-grade security Auto-updated by Vinkius

Built, hosted, and secured by Vinkius. You just connect and go.