Market Intelligence MCP
OfficialThe Market Intelligence MCP Server provides macro-economic analysis, market intelligence, real estate calculators, economic data access, and scenario planning for AI assistants.
Macro Intelligence
Recession Probability: 15-indicator weighted model (0–95%) with risk level, confidence, and recommendations
Recession Indicators: All model indicators with current values and risk scores
Fed Stance: Current Federal Reserve policy stance (TIGHTENING, EASING, CRISIS, or NEUTRAL)
Market Regime: Current cycle phase (EARLY_CYCLE, MID_CYCLE, LATE_CYCLE, or RECESSION)
Confirmation Status: 4 coincident indicators (GDP, Industrial Production, Personal Income, Employment) confirming or denying recession signals
Sahm Rule: Recession indicator (triggers at 0.50)
Markets & Institutional Analysis
Capital Rotation Score: Composite risk-on/risk-off score (−100 to +100) across 9 macro instruments (DXY, Gold, Oil, Copper, VIX, 10Y Yield, Gold/Silver Ratio, SOFR, Bitcoin)
Divergence Alerts: Active correlation breakdowns between instruments with severity and implications
Institutional Positioning: CFTC futures positioning and cross-border capital flow insights
Real Estate Calculators
Investment Property Analysis: Cap rate, cash-on-cash ROI, monthly cash flow, NOI, DSCR, and 1% rule
BRRRR Analysis: Deal scoring (0–100) with ARV margin, refinance cash-out, and 70% rule check
Economic Data
Indicators: Time-series data for any tracked indicator (GDP, UNRATE, CPIAUCSL, DFF, etc.) plus keyword search
Curated Datasets: Interest rates, inflation (CPI, PCE, breakevens), employment (payrolls, JOLTS, claims), housing (starts, Case-Shiller, mortgage rates), yield curve (10Y-2Y and 10Y-3M spreads), and market sentiment (VIX, Financial Conditions/Stress Index, Consumer Sentiment)
Cascade Engine (Macro Scenario Analysis)
10 Catalyst Scenarios: Oil supply shock, Fed emergency cut, China-Taiwan escalation, trade war, and more
Chain-Reaction Analysis: Full cascade mapping with live data enrichment
Search & Filter: Find scenarios by keyword or category (geopolitical, monetary, credit, commodity, currency, contagion, structural)
Market Intelligence MCP Server
Recession probability, sector rotation, institutional positioning, macro cascade scenario analysis, real estate calculators, and real-time economic data — for Claude, ChatGPT, Cursor, and any MCP client.
Powered by the BullrunData API.
Quick Start (hosted — recommended)
The hosted endpoint at https://bullrundata.com/api/mcp is the fastest path. No install, auto-updates, and every MCP client below supports it natively.
Get a free API key at bullrundata.com — 100 calls/day, no credit card.
Claude Code
claude mcp add --transport http bullrundata https://bullrundata.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"Cursor
Add to ~/.cursor/mcp.json (or the project-local .cursor/mcp.json):
{
"mcpServers": {
"bullrundata": {
"url": "https://bullrundata.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}VS Code
Add to .vscode/mcp.json (workspace) or your user mcp.json:
{
"servers": {
"bullrundata": {
"type": "http",
"url": "https://bullrundata.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"bullrundata": {
"serverUrl": "https://bullrundata.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Claude Desktop
Claude Desktop doesn't speak HTTP MCP natively yet — bridge via mcp-remote. Add to claude_desktop_config.json:
{
"mcpServers": {
"bullrundata": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://bullrundata.com/api/mcp",
"--header",
"Authorization: Bearer YOUR_API_KEY"
]
}
}
}You can also skip the header entirely — on first connect, mcp-remote opens an OAuth flow in your browser and auto-provisions a free-tier key.
If you'd rather run the server locally (e.g. air-gapped environments, custom auth), install via npm:
Claude Desktop:
{
"mcpServers": {
"market-intelligence": {
"command": "npx",
"args": ["-y", "@bullrundata/market-intelligence"],
"env": {
"BULLRUNDATA_API_KEY": "your-api-key"
}
}
}
}Claude Code:
claude mcp add market-intelligence -- npx -y @bullrundata/market-intelligenceSet BULLRUNDATA_API_KEY in the environment where the command runs.
Related MCP server: FeedOracle Macro MCP
Available Tools
Macro Intelligence
Tool | Description |
| One-call macro snapshot — recession probability, market regime, Fed stance, and key indicators |
| Proprietary recession probability model with confirmation layer |
| Curated key metrics block from the dashboard summary |
| Current Fed monetary policy stance and Fed funds rate |
| Market cycle phase (early / mid / late_cycle / recession) |
| Coincident-indicator confirmation slice for the recession model |
Markets & Institutional
Tool | Description |
| Risk-on/risk-off signal from S&P sector performance (cyclical vs defensive) with leaders/laggards |
| Per-sector accumulation and distribution signals |
| Aggregate institutional futures positioning across major contracts |
| List available contracts for use with |
| Per-contract smart-money breakdown with week-over-week change |
| Treasury International Capital flows — net foreign Treasury demand |
Real Estate Calculators
Tool | Description |
| Rental property analysis: cap rate, DSCR, cash flow, 1% rule |
| BRRRR deal scoring (0-100) with 70% rule and full breakdown |
Economic Data
Tool | Description |
| Time series for any tracked indicator (VIXCLS, UNRATE, CPIAUCSL, T10Y2Y, etc.) |
| List all tracked indicators, optionally filtered by category |
| Fed Policy + Interest Rates categories |
| All Inflation-category indicators |
| Labor Market category (unemployment, payrolls, claims, JOLTS) |
| Housing category (mortgage rates, starts, permits, prices) |
| 10Y-2Y and 10Y-3M spreads with inversion check |
| Markets + Financial Conditions + Consumer Sentiment |
Cascade Engine (Macro Scenario Analysis)
Tool | Description |
| List all macro catalyst scenarios |
| Full chain reaction for a catalyst with live data enrichment |
| Search catalysts by keyword (e.g., "oil", "dollar", "china") |
| Filter by category: geopolitical, monetary, credit, commodity, currency, structural |
Available Catalysts: Oil Supply Shock, Dollar Liquidity Squeeze, Fed Emergency Rate Cut, US Recession, China-Taiwan Escalation, Yield Curve Inversion, Credit Market Freeze, EM Currency Crisis, Trade War Escalation, Sovereign Debt Crisis
Example Conversations
"What's the current recession risk?"
Claude uses recession_probability and returns:
Current recession probability is 37.9% (moderate risk). Fed stance: neutral. Market regime: mid-cycle. Recommendation: Mixed signals require caution. Begin defensive rotation.
"Is this a good time to buy an investment property at $450K?"
Claude uses investment_property_analysis + interest_rates:
At $450K with 20% down at 7%, monthly cash flow is $287. Cap rate: 5.3%. Cash-on-cash: 4.2%. DSCR: 1.18 (healthy). Current 30Y mortgage rate: 6.38%.
"What's the market risk-on/risk-off signal?"
Claude uses sectors_rotation + institutional_cftc:
Sector rotation signal: RISK_ON. Cyclical sectors leading, defensive lagging. Institutional positioning aligned risk-seeking. Playbook: stay overweight cyclicals, watch for rotation breakdown.
"What happens if oil hits $120?"
Claude uses cascade_analysis + sectors_rotation:
Oil Supply Shock cascade: Dollar demand surges (mechanical) -> Asian FX reserves drain (likely, weeks) -> Asian equity outflows (likely) -> Forced rate hikes in Asia (probable, months). Current sector rotation: RISK_ON, but energy sector lagging suggests market hasn't priced supply risk yet. Playbook: inflation hedges and cash reserves. Watch Fed swap line usage for systemic signal.
Configuration
For the hosted endpoint, authentication is passed as a Bearer header in your client config (see Quick Start above) or negotiated via OAuth on first connect — no environment variables needed.
For the local npx install:
Environment Variable | Required | Description |
| Yes | Your API key from bullrundata.com |
Pricing
Tier | Calls/Day | Price |
Free | 100 | $0 |
Pro | 10,000 | $29/mo |
Business | 100,000 | $99/mo |
Troubleshooting
Tools don't appear in Claude after install
Confirm the MCP server is registered: in Claude Desktop, check Settings → Connectors (or Developer) for
market-intelligence. In Claude Code, runclaude mcp list.Restart Claude Desktop fully (quit, not just close window) — connector changes don't hot-reload.
Verify your
BULLRUNDATA_API_KEYenv var is set and valid. Without it, tools fail at first call.If using the remote server (
https://market.bullrundata.com/mcp) directly, complete the OAuth flow in your browser when prompted — Claude needs the bearer token before it can call tools.
401 Unauthorized from a tool
Your API key is missing, expired, or inactive. Get a fresh one at bullrundata.com/login. For the remote server flow, re-authenticate via the OAuth screen; the connector auto-provisions a free-tier key on first connect.
429 Too Many Requests
You hit your daily rate limit. Limits reset at 00:00 UTC.
Tier | Limit |
Free | 100 requests/day |
Pro | 10,000 requests/day |
Business | 100,000 requests/day |
Upgrade at bullrundata.com/pricing or wait for the UTC reset.
OAuth flow stuck or times out (remote server)
The remote server uses GitHub OAuth. If the redirect hangs:
Confirm cookies and pop-ups are allowed for
market.bullrundata.comandclaude.aiTry authorizing in an incognito window (clears cached OAuth state)
Check that
https://market.bullrundata.com/.well-known/oauth-authorization-serverreturns 200 in your browser
First request is slow (~2–4 seconds)
Cold-start latency on the serverless deploy. Subsequent requests in the same session should respond in <500ms.
cascade_analysis returns "live data unavailable"
The cascade tool optionally enriches with live BullrunData market data. If the upstream API is briefly unreachable, you'll still get the full catalyst tree — only the live overlay is skipped. Pass include_live_data: false to skip the live fetch entirely.
Tool returns stale data
Economic indicators refresh multiple times daily. Check data_freshness in dashboard_summary for the last refresh timestamp.
Still stuck
Open an issue at GitHub Issues or email support@bullrundata.com with: tool name, full error message, and approximate timestamp.
Support
Website: bullrundata.com
Docs: bullrundata.com/docs
Issues: GitHub Issues
License
Elastic License 2.0 — see LICENSE.
You may use, modify, and redistribute this software. You may not offer it as a hosted or managed service that provides users with access to a substantial set of the features or functionality of the software.
Available Tools
23 toolsbrrrr_analysisARead-only
Analyze a BRRRR (Buy, Rehab, Rent, Refinance, Repeat) real estate deal. Returns all-in cost, ARV margin, refinance cash-out, monthly cash flow, BRRRR Score (0-100), 70% rule check, and full breakdown.
Inputs: purchasePrice (required), arv (required), monthlyRent (required), rehabCosts, +16 more.
capital_rotation_instrumentsARead-only
Get detailed scoring for all 9 macro instruments in the capital rotation model. Each instrument includes price, weighted score, signal direction, interpretation, and risk classification.
Inputs: no named parameters.
capital_rotation_scoreARead-only
Get the current capital rotation risk-on/risk-off composite score (-100 to +100) based on 9 macro instruments (DXY, Gold, Oil, Copper, VIX, 10Y Yield, Gold/Silver Ratio, SOFR, Bitcoin). Includes regime detection and asset allocation playbook.
Inputs: no named parameters.
cascade_analysisARead-only
Get the full chain reaction cascade for a macro catalyst scenario. Maps cause-effect chains across markets, regions, and asset classes with confidence levels, historical precedents, and live market data enrichment. Use cascade_list to see available catalysts.
Inputs: catalyst_id (required), include_live_data.
cascade_by_categoryARead-only
Get all catalyst scenarios in a specific category. Categories: geopolitical, monetary, credit, commodity, currency, contagion, structural.
Inputs: category (required).
cascade_listARead-only
List all available macro catalyst scenarios in the Cascade Engine. Returns catalyst IDs, names, categories, and severity levels. Use a catalyst ID with cascade_analysis for the full chain reaction.
Inputs: no named parameters.
cascade_searchARead-only
Search catalyst scenarios by keyword. Matches against catalyst names, descriptions, categories, and trigger conditions. Use this when you're not sure which catalyst applies to a given situation.
Inputs: query (required).
confirmation_statusARead-only
Check 4 coincident economic indicators that confirm or deny recession signals: Real GDP Growth, Industrial Production, Real Personal Income, Employment Level.
Inputs: no named parameters.
divergence_alertsARead-only
Get active correlation breakdowns between macro instruments (e.g., DXY and Gold both rising = systemic fear). Includes severity, implication, and momentum shift detection.
Inputs: no named parameters.
economic_indicatorBRead-only
Get time series data for any economic indicator by series ID (e.g., GDP, UNRATE, CPIAUCSL). Returns date-value pairs.
Inputs: series_id (required), limit, start_date, units.
employment_dataARead-only
Get current employment indicators: unemployment rate, nonfarm payrolls, initial claims, JOLTS openings and quits rate, participation rate, average hourly earnings.
Inputs: no named parameters.
fed_stanceARead-only
Get the current Federal Reserve monetary policy stance (TIGHTENING, EASING, CRISIS, or NEUTRAL) based on fed funds rate trajectory and 6-month rate change.
Inputs: no named parameters.
housing_dataARead-only
Get current housing market data: 30Y and 15Y mortgage rates, housing starts, building permits, median sales price, Case-Shiller index, existing home sales.
Inputs: no named parameters.
inflation_dataARead-only
Get current inflation indicators: CPI, Core CPI, PCE, Core PCE, 10-year breakeven inflation, and consumer inflation expectations.
Inputs: no named parameters.
interest_ratesARead-only
Get current interest rates: Fed funds, 2Y/5Y/10Y/30Y Treasury yields, 3M T-Bill, prime rate, 30-year and 15-year mortgage rates.
Inputs: no named parameters.
investment_property_analysisARead-only
Analyze a rental investment property. Returns cap rate, cash-on-cash ROI, monthly cash flow, NOI, DSCR, 1% rule evaluation, and full expense breakdown.
Inputs: purchasePrice (required), monthlyRent (required), downPaymentPct, interestRate, +8 more.
market_regimeARead-only
Get the current market cycle phase: EARLY_CYCLE, MID_CYCLE, LATE_CYCLE, or RECESSION. Based on unemployment trend, ISM PMI, yield curve, and credit spreads.
Inputs: no named parameters.
market_sentimentARead-only
Get market sentiment indicators: VIX (fear index), Financial Conditions Index, Financial Stress Index, and Consumer Sentiment.
Inputs: no named parameters.
recession_indicatorsARead-only
Get all recession model indicators with current values and risk scores.
Inputs: no named parameters.
recession_probabilityARead-only
Get the current US recession probability (0-95%) from a 15-indicator weighted model with dynamic Fed stance and market regime adjustments. Includes risk level, confidence, confirmation status, and actionable recommendation.
Inputs: no named parameters.
sahm_ruleARead-only
Check the Sahm Rule recession indicator. The 3-month moving average of unemployment minus the 12-month minimum. Triggers at 0.50 — has predicted every US recession since 1970.
Inputs: no named parameters.
search_indicatorsARead-only
Search for economic indicators by keyword. Returns matching series with ID, name, frequency, and last updated date.
Inputs: query (required), limit.
yield_curveARead-only
Get yield curve analysis: 10Y-2Y and 10Y-3M spreads, all Treasury yields, and inversion detection.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 23 tools
Each tool targets a distinct aspect of market intelligence—real estate, macro indicators, recession models, yield curves, etc. Potential overlaps like recession_indicators and recession_probability are differentiated by their outputs, with one listing raw indicators and the other providing a composite probability. The cascade suite is clearly organized with separate tools for listing, searching, and analyzing by category.
Most tools follow a noun_noun pattern (e.g., housing_data, recession_probability), but there are deviations: search_indicators uses a verb_noun pattern, and cascade_by_category includes a preposition. This inconsistency is minor and does not impede readability, but a uniform verb_noun or noun_noun convention would improve predictability.
With 23 tools, the server covers a broad domain without being overwhelming. Each tool serves a clearly defined function, and the count aligns well with the scope of market intelligence. Slightly towards the upper end of reasonable, but justified by the diversity of macroeconomic and real estate analysis subdomains.
The toolset thoroughly covers macroeconomic indicators, recession prediction, yield curves, and real estate investment analysis. However, it lacks certain areas like sector-level stock analysis, commodity prices beyond the capital rotation model, or detailed forex data. Overall, core workflows are well-supported, with only minor gaps.
Maintenance
Related MCP Connectors
Live macro data for AI agents: regime, conditions, liquidity, with input provenance. No signup.
macro-snapshot MCP — the state of the economy in one call.
Macro forecasts for inflation, rates, labor, GDP, housing, commodities, currencies, and equities.
Macroeconomic and market data for AI agents: rates, credit, volatility, calendars and screeners.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceUS Macro Economic Intelligence MCP — 8 tools for Fed rates, inflation, yield curve, labor market, GDP via FRED. Part of ToolOracle.-
- FlicenseNot gradedqualityDmaintenanceMacro economic intelligence MCP — 13 tools powered by 86 FRED series + ECB data covering Fed rates, inflation (CPI/PCE), yield curve, GDP, recession probability, and regime classification. Every response ES256K signed.1-
- AlicenseNot gradedqualityDmaintenanceEconomic data MCP server that connects FRED, BLS, BEA, IMF, World Bank, and ECB to any MCP-compatible client, with built-in methodology rules to guide LLMs in selecting appropriate economic indicators.MIT
- AlicenseNot gradedqualityCmaintenanceAgent-ready economic, market & geo-health intelligence — 163 MCP tools, 155 driver-backed indices.MIT