Rumble MCP

⚠️ Disclaimer: This tool requires a valid subscription to TheRumble.app. It is intended for personal use only. Any misuse of this tool is not the responsibility of the developer. By using this tool, you agree to comply with TheRumble's terms of service.

An MCP (Model Context Protocol) server that provides AI assistants with access to TheRumble.app investment research data for the Egyptian stock market (EGX).

Quick Install

Features

Installation

Option 1: npx (No Installation Required)

npx rumble-mcp

Option 2: Global Install

npm install -g rumble-mcp

Option 3: From Source

git clone https://github.com/AndrewHossam/rumble-mcp.git
cd rumble-mcp
npm install && npm run build
npm link  # Makes 'rumble-mcp' globally available

Getting Your Credentials

TheRumble uses Firebase authentication. To prevent your token from expiring every hour, you should use both an ID token and a Refresh token.

Run the helper script to get both:

npx rumble-mcp extract-token
# OR inside the project
npm run extract-token

Paste the generated script into your browser console on therumble.app. It will give you the .env content to copy.

Why use a refresh token?

• Without it: Credentials expire in 1 hour

• With it: The MCP auto-refreshes your session indefinitely 🚀

IDE & AI Client Setup

VS Code / VS Code Insiders

1. Click the Install in VS Code button above, or

2. Open Settings (Cmd+,) → search "MCP" → Add server configuration:

{
  "mcp": {
    "servers": {
      "rumble": {
        "command": "npx",
        "args": ["rumble-mcp"],
        "env": {
          "RUMBLE_FIREBASE_TOKEN": "your_firebase_token",
          "RUMBLE_REFRESH_TOKEN": "your_refresh_token",
          "RUMBLE_MARKET": "EGY"
        }
      }
    }
  }
}

Cursor

1. Click the Install in Cursor button above, or

2. Go to Settings → MCP Servers → Add:

{
  "rumble": {
    "command": "npx",
    "args": ["rumble-mcp"],
    "env": {
      "RUMBLE_FIREBASE_TOKEN": "your_firebase_token",
      "RUMBLE_REFRESH_TOKEN": "your_refresh_token",
      "RUMBLE_MARKET": "EGY"
    }
  }
}

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "rumble": {
      "command": "npx",
      "args": ["rumble-mcp"],
      "env": {
        "RUMBLE_FIREBASE_TOKEN": "your_firebase_token",
        "RUMBLE_REFRESH_TOKEN": "your_refresh_token",
        "RUMBLE_MARKET": "EGY"
      }
    }
  }
}

Claude Code (Anthropic)

claude mcp add rumble -- npx rumble-mcp

Then set your tokens:

export RUMBLE_FIREBASE_TOKEN="your_firebase_token"
export RUMBLE_REFRESH_TOKEN="your_refresh_token"
export RUMBLE_MARKET="EGY"  # Optional, defaults to EGY

🤖 Other AI Clients (Windsurf, Continue, etc.)

Most MCP-compatible clients follow a similar pattern:

{
  "name": "rumble",
  "command": "npx",
  "args": ["rumble-mcp"],
  "env": {
    "RUMBLE_FIREBASE_TOKEN": "your_firebase_token",
    "RUMBLE_REFRESH_TOKEN": "your_refresh_token",
    "RUMBLE_MARKET": "EGY"
  }
}

Available Tools

get_call_details Usage

• Parameters: callId (required), type (optional: fundamental/technical), sections (optional: ["story", "performance", "updates"])

• Example:

  {"callId": "call_id_here", "sections": ["performance", "updates"]}

Example Usage

Once configured, ask your AI assistant:

"What are the current active fundamental calls on Rumble?"

"Get full details for call_id_here"

"Show me just the performance and updates for that symbol"

"Get the Bottom Fisher portfolio"

Environment Variables

Development

# Clone and setup
git clone https://github.com/AndrewHossam/rumble-mcp.git
cd rumble-mcp
npm install

# Development mode (hot reload)
npm run dev

# Build for production
npm run build

# Run tests
npm test

Developer Workflow & Safety

This project includes automated safety checks to prevent breaking changes:

• Pre-commit Hooks: Automatically builds the project before every commit to catch syntax and type errors.

• CI/CD: GitHub Actions automatically verifies builds and types on every push and pull request.

• Publish Safety: The project is locked to automatically run a fresh build before npm publish to ensure users always get the latest code.

Support & Sponsorship

If you find this MCP useful, consider supporting the project:

• Support via TipTea (Egypt Local: InstaPay / Vodafone Cash)

License

MIT © 2026