io.github.connerlambden/helium-mcp

Official

by connerlambden · JavaScript

Helium MCP Server - News, Markets & AI

Real-time news with bias scoring, live market data, and AI-powered options pricing

Real-time news and market data with bias analysis and options pricing.

Topics

aiclaudecursormarket-datamcpmcp-servermedia-biasmodel-context-protocolnewsoptionsstockstradingbias-detectioncopilotfinancial-datanlpsentiment-analysiswindsurfcryptomachine-learning

README.md10 KBView on GitHub

Helium MCP Server

Real-time news with bias scoring, live market data, and AI-powered options pricing — all accessible through the Model Context Protocol.

Overview

Helium MCP gives your AI assistant access to:

3.2M+ news articles from 5,000+ sources, each scored across 15+ bias dimensions
Balanced news synthesis — left, right, and center perspectives aggregated into one coherent story
Live market data — price, IV rank, AI-generated bull/bear cases, and price forecasts
AI options pricing — proprietary ML models for fair-value estimates and probability ITM
Meme search — semantic search across viral memes with OCR text and captions

50 free queries included. No sign-up required.

Quick Start

Cursor

Add to your Cursor MCP settings:

json

{
  "mcpServers": {
    "helium": {
      "url": "https://heliumtrades.com/mcp"
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

json

{
  "mcpServers": {
    "helium": {
      "type": "streamable-http",
      "url": "https://heliumtrades.com/mcp"
    }
  }
}

Windsurf

Add to your Windsurf MCP settings:

json

{
  "mcpServers": {
    "helium": {
      "serverUrl": "https://heliumtrades.com/mcp"
    }
  }
}

GitHub Copilot

Add to your .github/copilot-instructions.md or MCP config:

json

{
  "mcpServers": {
    "helium": {
      "type": "streamable-http",
      "url": "https://heliumtrades.com/mcp"
    }
  }
}

Any MCP Client

Connect to the streamable HTTP endpoint:

code

https://heliumtrades.com/mcp

Example Output

"What's the bull and bear case for Bitcoin?"

code

get_ticker("BTC")
→ Bitcoin: $71,040.01
  Bull case: "Institutional spot demand resumes... squeeze toward mid/upper-80ks to low-100ks"
  Bear case: "Higher-for-longer rates, persistent ETF outflows... slide into 40–55k plausible"
  Forecast: +1.8% over 37 days (range: -1.2% to +5.0%)
  IV Rank: available
  Options strategies: long vol + short vol packs included

"How biased is CNN?"

code

get_source_bias("CNN")
→ Emotionality: 7/10
  30+ bias dimensions scored (political lean, fearfulness, opinion, oversimplification...)
  Signature phrases: "trump threatens", "mortgage rates", "nuclear weapons"
  Similar sources: NBC, PBS, AP, Newsweek, CBS
  Per-article bias breakdown on recent stories included

"What are the best options trades right now?"

code

get_top_trading_strategies()
→ AI-ranked short vol + long vol setups
  Each includes: ticker, price, bull/bear case, 5 probability-weighted outcomes,
  full option pack (strike, expiry, Greeks, ML fair value, probability ITM)

"Give me NVIDIA's full analysis"

code

get_ticker("NVDA")
→ NVIDIA: $183.91
  5 probability-weighted scenarios (38% mean-revert, 25% +10-25%, 20% -5-12%...)
  Forecast: +4.2% over 37 days (range: -2.6% to +8.9%)
  IV rank, volatility surface, term structure, return profile charts
  27 time-horizon uncertainty visualizations (1-day to 995-day)

"Find me stock market crash memes"

code

search_memes("stock market crash")
→ Babylon Bee: "Kamala Desperately Googles 'What Is A Stock Market Crash'" (32K likes)
→ "Everyone: 'omg the stock market is crashing!' / 500 cigarettes adapter" (437K likes)
  Full OCR text, source, date, image URLs included

Tools

search_news

Full-text search across 3.2M+ articles from 5,000+ sources. Filter by source, category, date, and minimum shares. Returns bias scores, AI summaries, and context.

Parameters:

Parameter	Type	Required	Default	Description
`query`	string	Yes	—	Search keywords
`limit`	integer	No	20	Max results (1–100)
`source`	string	No	—	Filter by source name (e.g. `"CNN"`, `"Reuters"`)
`category`	string	No	—	One of: `trending`, `tech`, `markets`, `politics`, `business`, `science`, `memes`
`days_back`	integer	No	720	Only include articles from the last N days
`min_shares`	integer	No	-1	Minimum total social shares
`sort`	string	No	`"rank"`	One of: `rank` (relevance), `date` (newest), `shares` (most shared)

search_balanced_news

AI-synthesized articles that aggregate multiple sources into balanced coverage. Each story includes a summary, takeaway, evidence breakdown, potential outcomes, and relevant tickers.

Parameters:

Parameter	Type	Required	Default	Description
`query`	string	Yes	—	Search keywords
`limit`	integer	No	10	Max results (1–50)
`category`	string	No	—	One of: `tech`, `politics`, `markets`, `business`, `science`
`days_back`	integer	No	0	Only include stories from the last N days (0 = no filter)

get_source_bias

Deep bias analysis for any news outlet: political lean, emotional tone, prescriptiveness, signature phrases, similar sources, and historical trends.

Parameters:

Parameter	Type	Required	Default	Description
`source`	string	Yes	—	Source name (e.g. `"Fox News"`) or domain (e.g. `"foxnews.com"`)
`recent_articles`	integer	No	10	Number of recent articles to include (1–50)

get_bias_from_url

Analyze any article URL for per-dimension bias scores: political lean, emotionality, manipulation level, factfulness, and more.

Parameters:

Parameter	Type	Required	Default	Description
`url`	string	Yes	—	Full article URL

get_ticker

Comprehensive data for any stock, ETF, or crypto: live price, AI-generated bull/bear cases, price forecast, IV rank, volatility surface, and top-ranked options strategies.

Parameters:

Parameter	Type	Required	Default	Description
`ticker`	string	Yes	—	Ticker symbol (e.g. `"AAPL"`, `"SPY"`, `"BTC"`)

get_option_price

Helium's proprietary ML model-predicted fair-value price for a specific option contract. Returns predicted price, probability ITM, and the data date.

Parameters:

Parameter	Type	Required	Default	Description
`symbol`	string	Yes	—	Ticker symbol (e.g. `"AAPL"`, `"SPY"`)
`strike`	number	Yes	—	Strike price (e.g. `150.0`)
`expiration`	string	Yes	—	Expiration date as `YYYY-MM-DD`
`option_type`	string	Yes	—	`"call"` or `"put"`

get_top_trading_strategies

Helium's highest-conviction options setups ranked by AI edge score, expected value, and market conditions. Returns both short volatility and long volatility strategies.

Parameters:

Parameter	Type	Required	Default	Description
`sort`	string	No	`"helium_rank"`	One of: `helium_rank`, `odds_of_profit`, `historical_performance`, `reward_to_risk`, `smallest_max_loss`
`limit`	integer	No	5	Results per strategy type (1–20)

get_all_source_biases

Bias scores for every tracked news source — compare outlets, rank by credibility, or build a full media landscape overview. Returns all sources with >100 articles analyzed, sorted by average social shares.

Parameters: None required.

search_memes

Semantic search across viral memes — images, captions, OCR text, like counts, and source attribution.

Parameters:

Parameter	Type	Required	Default	Description
`query`	string	Yes	—	Search keywords (matched against OCR text and captions)
`limit`	integer	No	20	Max results (1–100)

Pricing

Plan	Cost	Details
Free	$0	50 queries per network — no sign-up needed
Pay As You Go	$0.02/query	Billed daily via Stripe. All 9 tools, unlimited queries.

Get an API key at heliumtrades.com/mcp-page.

Examples, Recipes & Interactive Demo

Helium News Bias Explorer — interactive single-page demo (zero dependencies) that fetches the live source-bias corpus and lets you rank, scatter, or inspect any of the 216 sources across all 37 bias dimensions. The fastest way to feel what the API can do without writing code.
Helium Ticker Forecast Dashboard — companion dashboard that renders the top 10 short-vol and long-vol candidates with ML 37-day forecasts, uncertainty cones, and bull/bear narratives. Single GET to mcp_top_strategies/.
helium-mcp-cookbook — seven runnable Python recipes covering news-bias ranking, options calibration tracking, balanced-news synthesis, source credibility ranking, ticker forecasts, top-strategies, and meme search. Each is one file you can run with python recipes/NN_name.py.

License

MIT

Install

claude_desktop_config.json

{
  "mcpServers": {
    "helium-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://heliumtrades.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Topics

Helium MCP Server

Overview

Quick Start

Cursor

Claude Desktop

Windsurf

GitHub Copilot

Any MCP Client

Example Output

Tools

search_news

search_balanced_news

get_source_bias

get_bias_from_url

get_ticker

get_option_price

get_top_trading_strategies

get_all_source_biases

search_memes

Pricing

Examples, Recipes & Interactive Demo

Links

License

Install