Market Intelligence MCP server

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

{
  "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 BULLRUNDATAAPIKEY in the environment where the command runs.

Available Tools

Macro Intelligence

Markets & Institutional

Shortened. The full README is on GitHub.