Market Intelligence MCP Server (io.github.jbrand0n/market-intelligence-mcp)

The Market Intelligence MCP Server provides recession probability, capital/sector rotation scoring, and real-time economic data via an API for use with Claude, ChatGPT, Cursor, and any MCP client. It is powered by the BullrunData API and is available through a hosted MCP endpoint.

🛠️ Key Features

Recession probability
Capital rotation scoring
Economic data API (real-time)
Sector rotation and institutional positioning
Macro cascade scenario analysis
Real estate calculators
Powered by BullrunData API

🚀 Use Cases

Evaluate recession likelihood using provided economic data
Score sector/capital rotation
Run macro cascade scenario analysis
Use real estate calculators alongside macro indicators

⚡ Developer Benefits

Hosted endpoint support at https://bullrundata.com/api/mcp (no install mentioned)
Auto-updates stated for hosted usage
Works with “any MCP client” that supports the hosted endpoint natively

⚠️ Limitations

Hosted quick start is described; installation details are not provided in the available data.
Free tier described as 100 calls/day with no credit card (key required).

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.

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

bash

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):

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:

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:

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:

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.

Local install (npm)

If you'd rather run the server locally (e.g. air-gapped environments, custom auth), install via npm:

Claude Desktop:

json

{
  "mcpServers": {
    "market-intelligence": {
      "command": "npx",
      "args": ["-y", "@bullrundata/market-intelligence"],
      "env": {
        "BULLRUNDATA_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code:

bash

claude mcp add market-intelligence -- npx -y @bullrundata/market-intelligence

Set BULLRUNDATA_API_KEY in the environment where the command runs.

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

Confirm the MCP server is registered: in Claude Desktop, check Settings → Connectors (or Developer) for market-intelligence. In Claude Code, run claude mcp list.
Restart Claude Desktop fully (quit, not just close window) — connector changes don't hot-reload.
Verify your BULLRUNDATA_API_KEY env 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.com and claude.ai
Try authorizing in an incognito window (clears cached OAuth state)
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.