Skip to main content
Glama
Market Intelligence MCP

Market Intelligence MCP

Official
by BullrunData

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.

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-intelligence

Set BULLRUNDATA_API_KEY in the environment where the command runs.

Related MCP server: FeedOracle Macro MCP

Available Tools

Macro Intelligence

Tool

Description

dashboard_summary

One-call macro snapshot — recession probability, market regime, Fed stance, and key indicators

recession_probability

Proprietary recession probability model with confirmation layer

recession_indicators

Curated key metrics block from the dashboard summary

fed_stance

Current Fed monetary policy stance and Fed funds rate

market_regime

Market cycle phase (early / mid / late_cycle / recession)

confirmation_status

Coincident-indicator confirmation slice for the recession model

Markets & Institutional

Tool

Description

sectors_rotation

Risk-on/risk-off signal from S&P sector performance (cyclical vs defensive) with leaders/laggards

sectors_flows

Per-sector accumulation and distribution signals

institutional_cftc

Aggregate institutional futures positioning across major contracts

cftc_contracts_list

List available contracts for use with cftc_positioning_detail

cftc_positioning_detail

Per-contract smart-money breakdown with week-over-week change

institutional_tic

Treasury International Capital flows — net foreign Treasury demand

Real Estate Calculators

Tool

Description

investment_property_analysis

Rental property analysis: cap rate, DSCR, cash flow, 1% rule

brrrr_analysis

BRRRR deal scoring (0-100) with 70% rule and full breakdown

Economic Data

Tool

Description

economic_indicator

Time series for any tracked indicator (VIXCLS, UNRATE, CPIAUCSL, T10Y2Y, etc.)

list_indicators

List all tracked indicators, optionally filtered by category

interest_rates

Fed Policy + Interest Rates categories

inflation_data

All Inflation-category indicators

employment_data

Labor Market category (unemployment, payrolls, claims, JOLTS)

housing_data

Housing category (mortgage rates, starts, permits, prices)

yield_curve

10Y-2Y and 10Y-3M spreads with inversion check

market_sentiment

Markets + Financial Conditions + Consumer Sentiment

Cascade Engine (Macro Scenario Analysis)

Tool

Description

cascade_list

List all macro catalyst scenarios

cascade_analysis

Full chain reaction for a catalyst with live data enrichment

cascade_search

Search catalysts by keyword (e.g., "oil", "dollar", "china")

cascade_by_category

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

BULLRUNDATA_API_KEY

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

  1. Confirm the MCP server is registered: in Claude Desktop, check Settings → Connectors (or Developer) for market-intelligence. In Claude Code, run claude mcp list.

  2. Restart Claude Desktop fully (quit, not just close window) — connector changes don't hot-reload.

  3. Verify your BULLRUNDATA_API_KEY env var is set and valid. Without it, tools fail at first call.

  4. 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:

  1. Confirm cookies and pop-ups are allowed for market.bullrundata.com and claude.ai

  2. Try authorizing in an incognito window (clears cached OAuth state)

  3. Check that https://market.bullrundata.com/.well-known/oauth-authorization-server returns 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

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 tools
brrrr_analysisA
Read-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_instrumentsA
Read-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_scoreA
Read-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_analysisA
Read-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_categoryA
Read-only

Get all catalyst scenarios in a specific category. Categories: geopolitical, monetary, credit, commodity, currency, contagion, structural.

Inputs: category (required).

cascade_listA
Read-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.

confirmation_statusA
Read-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_alertsA
Read-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_indicatorB
Read-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_dataA
Read-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_stanceA
Read-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_dataA
Read-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_dataA
Read-only

Get current inflation indicators: CPI, Core CPI, PCE, Core PCE, 10-year breakeven inflation, and consumer inflation expectations.

Inputs: no named parameters.

interest_ratesA
Read-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_analysisA
Read-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_regimeA
Read-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_sentimentA
Read-only

Get market sentiment indicators: VIX (fear index), Financial Conditions Index, Financial Stress Index, and Consumer Sentiment.

Inputs: no named parameters.

recession_indicatorsA
Read-only

Get all recession model indicators with current values and risk scores.

Inputs: no named parameters.

recession_probabilityA
Read-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_ruleA
Read-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_indicatorsA
Read-only

Search for economic indicators by keyword. Returns matching series with ID, name, frequency, and last updated date.

Inputs: query (required), limit.

yield_curveA
Read-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

    A3.9/5.0

    Scored across 23 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      US Macro Economic Intelligence MCP — 8 tools for Fed rates, inflation, yield curve, labor market, GDP via FRED. Part of ToolOracle.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Macro 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
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Economic 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